Función GetFileBandwidthReservation (winbase.h)
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 |