GetFileBandwidthReservation-Funktion (winbase.h)
Ruft die Bandbreitenreservierungseigenschaften des Volumes ab, auf dem sich die angegebene Datei befindet.
Syntax
BOOL GetFileBandwidthReservation(
[in] HANDLE hFile,
[out] LPDWORD lpPeriodMilliseconds,
[out] LPDWORD lpBytesPerPeriod,
[out] LPBOOL pDiscardable,
[out] LPDWORD lpTransferSize,
[out] LPDWORD lpNumOutstandingRequests
);
Parameter
[in] hFile
Ein Handle zur Datei.
[out] lpPeriodMilliseconds
Ein Zeiger auf eine Variable, die den Zeitraum der Reservierung in Millisekunden empfängt. Der Zeitraum ist der Zeitraum, ab dem die E/A an den Kernel ausgegeben wird, bis zu dem Zeitpunkt, zu dem die E/A abgeschlossen werden soll. Wenn für dieses Handle keine Bandbreite reserviert wurde, ist der zurückgegebene Wert der Mindestreservierungszeitraum, der für dieses Volume unterstützt wird.
[out] lpBytesPerPeriod
Ein Zeiger auf eine Variable, die die maximale Anzahl von Bytes pro Zeitraum empfängt, die auf dem Volume reserviert werden können. Wenn für dieses Handle keine Bandbreite reserviert wurde, ist der zurückgegebene Wert die maximale Anzahl von Bytes pro Zeitraum, die für das Volume unterstützt wird.
[out] pDiscardable
TRUE , wenn die E/A mit einem Fehler abgeschlossen werden soll, wenn ein Treiber einen E/A-Vorgang vor Ablauf des Zeitraums nicht erfüllen kann. FALSE , wenn das zugrunde liegende Subsystem fehler auf diese Weise nicht unterstützt.
[out] lpTransferSize
Die Mindestgröße jeder einzelnen E/A-Anforderung, die von der Anwendung ausgestellt werden kann. Alle E/A-Anforderungen sollten ein Vielfaches von TransferSize sein. Wenn für dieses Handle keine Bandbreite reserviert wurde, ist der zurückgegebene Wert die mindest unterstützte Übertragungsgröße für dieses Volume.
[out] lpNumOutstandingRequests
Die Anzahl der TransferSize-Blöcke , die für das Betriebssystem ausstehend sein dürfen.
Rückgabewert
Gibt ungleich null zurück, wenn erfolgreich oder andernfalls null.
Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
Technologie | Unterstützt |
---|---|
SMB 3.0-Protokoll (Server Message Block) | No |
SMB 3.0 Transparent Failover (TFO) | No |
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) | No |
Dateisystem mit freigegebenen Clustervolumes (CsvFS) | No |
Robustes Dateisystem (Resilient File System, ReFS) | Ja |
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winbase.h (Windows.h einschließen) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |