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 Irp-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 contém o número de bytes retornados no buffer de saída. Um dos valores a seguir pode ser retornado no campo Status .
| 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 . |
| STATUS_BUFFER_TOO_SMALL | O tamanho do buffer é muito pequeno para retornar a saída. |
Comentários
Um driver ou aplicativo pode consultar o tamanho do buffer de saída necessário definindo o buffer de saída da solicitação como NULL e o tamanho da saída como 0. A solicitação IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES retornará com o campo Status do bloco IoStatus definido como STATUS_BUFFER_OVERFLOW e o campo Informações conterá o tamanho do buffer necessário.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8 |
| Cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |