GetFileBandwidthReservation, fonction (winbase.h)
Récupère les propriétés de réservation de la bande passante du volume sur lequel se trouve le fichier spécifié.
Syntaxe
BOOL GetFileBandwidthReservation(
[in] HANDLE hFile,
[out] LPDWORD lpPeriodMilliseconds,
[out] LPDWORD lpBytesPerPeriod,
[out] LPBOOL pDiscardable,
[out] LPDWORD lpTransferSize,
[out] LPDWORD lpNumOutstandingRequests
);
Paramètres
[in] hFile
Descripteur du fichier.
[out] lpPeriodMilliseconds
Pointeur vers une variable qui reçoit la période de la réservation, en millisecondes. La période est la période à partir de laquelle les E/S sont émises au noyau jusqu’à l’heure à laquelle les E/S doivent être terminées. Si aucune bande passante n’a été réservée pour ce handle, la valeur retournée est la période de réservation minimale prise en charge pour ce volume.
[out] lpBytesPerPeriod
Pointeur vers une variable qui reçoit le nombre maximal d’octets par période pouvant être réservés sur le volume. Si aucune bande passante n’a été réservée pour ce handle, la valeur retournée est le nombre maximal d’octets par période pris en charge pour le volume.
[out] pDiscardable
TRUE si les E/S doivent être effectuées avec une erreur si un pilote ne parvient pas à satisfaire une opération d’E/S avant l’expiration de la période. FALSE si le sous-système sous-jacent ne prend pas en charge l’échec de cette manière.
[out] lpTransferSize
Taille minimale de toute demande d’E/S individuelle qui peut être émise par l’application. Toutes les demandes d’E/S doivent être des multiples de TransferSize. Si aucune bande passante n’a été réservée pour ce handle, la valeur retournée est la taille de transfert minimale prise en charge pour ce volume.
[out] lpNumOutstandingRequests
Nombre de blocs TransferSize autorisés à être en attente avec le système d’exploitation.
Valeur retournée
Retourne une valeur différente de zéro en cas de réussite ou de zéro dans le cas contraire.
Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Prise en charge |
|---|---|
| Protocole Server Message Block (SMB) 3.0 | No |
| Basculement transparent SMB 3.0 (TFO) | No |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | No |
| Système de fichiers du volume partagé de cluster (CsvFS) | No |
| Système de fichiers résilient (ReFS) | Oui |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |