IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS IOCTL (ehstorbandmgmt.h)
Essa solicitação IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS é enviada para recuperar a lista de bandas de um dispositivo de armazenamento no gerenciamento de banda. As informações de faixa são retornadas em uma tabela de entradas de banda que inclui propriedades de segurança e localização da banda.
Código principal
Buffer de entrada
O buffer em >AssociatedIrp.SystemBuffer deve conter uma estrutura ENUMERATE_BANDS_PARAMETERS.
Comprimento do buffer de entrada
Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer, que deve ter pelo menos tamanho de (ENUMERATE_BANDS_PARAMETERS).
Buffer de saída
O buffer em >AssociatedIrp.SystemBuffer contém uma estrutura BAND_TABLE seguida por entradas de banda BandTableEntryCount.
Comprimento do buffer de saída
O comprimento de uma estrutura de BAND_TABLE seguida por entradas de banda BandTableEntryCount.
Bloco de status
O campo informações de contém o número de bytes retornados no buffer de saída. Um dos valores a seguir pode ser retornado no campo status do.
| Valor do status | Descrição |
|---|---|
| STATUS_SUCCESS | Os recursos de segurança no dispositivo de armazenamento foram desativados. |
| STATUS_INVALID_DEVICE_REQUEST | O dispositivo de armazenamento não dá suporte ao gerenciamento de banda. |
| STATUS_INVALID_BUFFER_SIZE | O tamanho do buffer de entrada é inválido. |
| STATUS_INVALID_PARAMETER | As informações no buffer de entrada são inválidas. |
| STATUS_NOT_FOUND | Nenhuma banda é configurada para os parâmetros de enumeração fornecidos. |
| STATUS_BUFFER_OVERFLOW | Um buffer não é fornecido ou seu tamanho definido como zero. O tamanho necessário é retornado no campo informações do. |
| STATUS_IO_DEVICE_ERROR | Falha na comunicação. O dispositivo de armazenamento pode ser incompatível com protocolos de segurança. |
| STATUS_BUFFER_TOO_SMALL | O buffer de saída fornecido não é grande o suficiente para manter os dados de saída retornados. |
Observações
Um driver ou aplicativo pode consultar o tamanho necessário do buffer de saída definindo o buffer de saída da solicitação como NULL e o tamanho da saída como 0. A solicitação de IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS retornará com o campo status do bloco de IoStatus definido como STATUS_BUFFER_OVERFLOW e o campo informações conterá o tamanho do buffer necessário.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8. |
| cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |
Consulte também
ENUMERATE_BANDS_PARAMETERS