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 |