Función GetFileBandwidthReservation (winbase.h)

  • Artículo

Recupera las propiedades de reserva de ancho de banda del volumen en el que reside el archivo especificado.

Sintaxis

BOOL GetFileBandwidthReservation(
  [in]  HANDLE  hFile,
  [out] LPDWORD lpPeriodMilliseconds,
  [out] LPDWORD lpBytesPerPeriod,
  [out] LPBOOL  pDiscardable,
  [out] LPDWORD lpTransferSize,
  [out] LPDWORD lpNumOutstandingRequests
);

Parámetros

[in] hFile

Identificador del archivo.

[out] lpPeriodMilliseconds

Puntero a una variable que recibe el período de la reserva, en milisegundos. El período es el tiempo desde el que se emite la E/S al kernel hasta que se debe completar la E/S. Si no se ha reservado ningún ancho de banda para este identificador, el valor devuelto es el período de reserva mínimo admitido para este volumen.

[out] lpBytesPerPeriod

Puntero a una variable que recibe el número máximo de bytes por período que se puede reservar en el volumen. Si no se ha reservado ningún ancho de banda para este identificador, el valor devuelto es el número máximo de bytes por período admitido para el volumen.

[out] pDiscardable

TRUE si se debe completar la E/S con un error si un controlador no puede satisfacer una operación de E/S antes de que expire el período. FALSE si el subsistema subyacente no admite errores de esta manera.

[out] lpTransferSize

Tamaño mínimo de cualquier solicitud de E/S individual que la aplicación pueda emitir. Todas las solicitudes de E/S deben ser múltiplas de TransferSize. Si no se ha reservado ningún ancho de banda para este identificador, el valor devuelto es el tamaño mínimo de transferencia admitido para este volumen.

[out] lpNumOutstandingRequests

El número de fragmentos TransferSize que pueden estar pendientes con el sistema operativo.

Valor devuelto

Devuelve un valor distinto de cero si es correcto o cero de lo contrario.

Para obtener información de error extendida, llame a GetLastError.

Comentarios

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 No
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) No
Sistema de archivos resistente a errores (ReFS) Sí

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de administración de archivos

SetFileBandwidthReservation