GetFileBandwidthReservation-Funktion (winbase.h)

Artikel
03/03/2024

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

Siehe auch

Dateiverwaltungsfunktionen

SetFileBandwidthReservation

Freigeben über