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

Voir aussi

Fonctions de gestion des fichiers

SetFileBandwidthReservation