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 中，下列技術支援此函式。

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 No
SMB 3.0 透明故障轉移 (TFO) No
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) No
彈性檔案系統 (ReFS) Yes

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

檔案管理功能

SetFileBandwidthReservation