Função GetFileBandwidthReservation (winbase.h)
Recupera as propriedades de reserva de largura de banda do volume no qual o arquivo especificado reside.
Sintaxe
BOOL GetFileBandwidthReservation(
[in] HANDLE hFile,
[out] LPDWORD lpPeriodMilliseconds,
[out] LPDWORD lpBytesPerPeriod,
[out] LPBOOL pDiscardable,
[out] LPDWORD lpTransferSize,
[out] LPDWORD lpNumOutstandingRequests
);
Parâmetros
[in] hFile
Um manipulador para o arquivo.
[out] lpPeriodMilliseconds
Um ponteiro para uma variável que recebe o período da reserva, em milissegundos. O período é o tempo do qual a E/S é emitida para o kernel até o momento em que a E/S deve ser concluída. Se nenhuma largura de banda tiver sido reservada para esse identificador, o valor retornado será o período mínimo de reserva com suporte para esse volume.
[out] lpBytesPerPeriod
Um ponteiro para uma variável que recebe o número máximo de bytes por período que podem ser reservados no volume. Se nenhuma largura de banda tiver sido reservada para esse identificador, o valor retornado será o número máximo de bytes por período com suporte para o volume.
[out] pDiscardable
TRUE se a E/S deve ser concluída com um erro se um driver não puder atender a uma operação de E/S antes que o período expire. FALSE se o subsistema subjacente não oferecer suporte a falhas dessa maneira.
[out] lpTransferSize
O tamanho mínimo de qualquer solicitação de E/S individual que possa ser emitida pelo aplicativo. Todas as solicitações de E/S devem ser múltiplas de TransferSize. Se nenhuma largura de banda tiver sido reservada para esse identificador, o valor retornado será o tamanho mínimo de transferência com suporte para esse volume.
[out] lpNumOutstandingRequests
O número de partes transferSize que podem ser pendentes com o sistema operacional.
Retornar valor
Retornará diferente de zero se tiver êxito ou zero caso contrário.
Para obter informações de erro estendidas, chame GetLastError.
Comentários
No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.
| Tecnologia | Com suporte |
|---|---|
| Protocolo SMB (SMB) 3.0 | No |
| TFO (Failover transparente) do SMB 3.0 | No |
| SMB 3.0 com compartilhamentos de arquivos de expansão (SO) | No |
| Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) | No |
| ReFS (Sistema de Arquivos Resiliente) | Sim |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (incluir Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |