Funzione GetFileBandwidthReservation (winbase.h)
Recupera le proprietà della prenotazione della larghezza di banda del volume in cui risiede il file specificato.
Sintassi
BOOL GetFileBandwidthReservation(
[in] HANDLE hFile,
[out] LPDWORD lpPeriodMilliseconds,
[out] LPDWORD lpBytesPerPeriod,
[out] LPBOOL pDiscardable,
[out] LPDWORD lpTransferSize,
[out] LPDWORD lpNumOutstandingRequests
);
Parametri
[in] hFile
Handle per il file.
[out] lpPeriodMilliseconds
Puntatore a una variabile che riceve il periodo della prenotazione, in millisecondi. Il periodo è l'ora da cui viene emesso l'I/O al kernel fino al completamento dell'I/O. Se non è stata riservata alcuna larghezza di banda per questo handle, il valore restituito è il periodo minimo di prenotazione supportato per questo volume.
[out] lpBytesPerPeriod
Puntatore a una variabile che riceve il numero massimo di byte per periodo che può essere riservato nel volume. Se non è stata riservata alcuna larghezza di banda per questo handle, il valore restituito è il numero massimo di byte per periodo supportato per il volume.
[out] pDiscardable
TRUE se l'I/O deve essere completato con un errore se un driver non è in grado di soddisfare un'operazione di I/O prima della scadenza del periodo. FALSE se il sottosistema sottostante non supporta l'esito negativo in questo modo.
[out] lpTransferSize
Dimensione minima di qualsiasi richiesta di I/O singola che può essere rilasciata dall'applicazione. Tutte le richieste di I/O devono essere multiple di TransferSize. Se non è stata riservata alcuna larghezza di banda per questo handle, il valore restituito è la dimensione minima di trasferimento supportata per questo volume.
[out] lpNumOutstandingRequests
Numero di blocchi TransferSize consentiti per essere in sospeso con il sistema operativo.
Valore restituito
Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario.
Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.
| Tecnologia | Supportato |
|---|---|
| Protocollo SMB (Server Message Block) 3.0 | No |
| Failover trasparente SMB 3.0 (TFO) | No |
| SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) | No |
| File system del volume condiviso del cluster (CsvFS) | No |
| File system resiliente (ReFS) | Sì |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |