IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES IOCTL (ehstorbandmgmt.h)
A solicitação IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES recupera os recursos de segurança em banda para um dispositivo de armazenamento. O IOCTL retorna os recursos como uma estrutura BAND_MANAGEMENT_CAPABILITIES no buffer do sistema.
Código principal
Buffer de entrada
Nenhum.
Comprimento do buffer de entrada
Nenhum.
Buffer de saída
O buffer de saída em >AssociatedIrp.SystemBuffer contém uma estrutura BAND_MANAGEMENT_CAPABILITIES.
Comprimento do buffer de saída
O comprimento de uma estrutura BAND_MANAGEMENT_CAPABILITIES.
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 | O dispositivo dá suporte ao gerenciamento de banda e os recursos de segurança são retornados no buffer do sistema. |
| STATUS_INVALID_DEVICE_REQUEST | Não há suporte para o gerenciamento de banda no dispositivo de armazenamento. |
| STATUS_INVALID_DEVICE_STATE | O dispositivo fornece suporte ao gerenciamento de banda, mas não em sua configuração atual. |
| 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_BUFFER_TOO_SMALL | O tamanho do buffer é muito pequeno para retornar a saída. |
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_QUERY_CAPABILITIES retornará com o campo de Status do bloco IoStatus definido como STATUS_BUFFER_OVERFLOW e o campo informações de 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) |