getFileBandwidthReservation 函式 (winbase.h)

擷取指定檔案所在磁碟區的頻寬保留屬性。

語法

BOOL GetFileBandwidthReservation(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpPeriodMilliseconds,
  [out] LPDWORD lpBytesPerPeriod,
  [out] LPBOOL  pDiscardable,
  [out] LPDWORD lpTransferSize,
  [out] LPDWORD lpNumOutstandingRequests
);

參數

[in] hFile

檔案的句柄。

[out] lpPeriodMilliseconds

接收保留期間之變數的指標，以毫秒為單位。 期間是從 I/O 發出到核心的時間，直到 I/O 應該完成為止。 如果此句柄未保留任何頻寬，則傳回的值就是此磁碟區支援的最小保留期間。

[out] lpBytesPerPeriod

變數的指標，可接收可在磁碟區上保留的每個期間的最大位元元組數目。 如果沒有保留此句柄的頻寬，則傳回的值是磁碟區所支援每個期間的最大位元組數目。

[out] pDiscardable

如果 驅動程式無法在期間到期之前滿足 I/O 作業，則為 TRUE。如果驅動程式無法滿足 I/O 作業，則為 TRUE。 如果 基礎子系統不支援以這種方式失敗，則為 FALSE。

[out] lpTransferSize

應用程式可能發出之任何個別 I/O 要求的大小下限。 所有 I/O 要求都應該是 TransferSize 的倍數。 如果沒有保留此句柄的頻寬，則傳回的值是此磁碟區支援的最小傳輸大小。

[out] lpNumOutstandingRequests

操作系統允許未完成的 TransferSize 區塊數目。

傳回值

如果成功或零，則傳回非零。

若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。

規格需求

另請參閱

檔案管理功能

SetFileBandwidthReservation