Função GetFileBandwidthReservation (winbase.h)

  • Artigo

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

Confira também

Funções de gerenciamento de arquivos

SetFileBandwidthReservation