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.

Requisiti

Vedere anche

Funzioni di gestione file

SetFileBandwidthReservation