IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Metadados associados a uma banda são recuperados com uma solicitação IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA. Os metadados de uma banda servem como uma área de dados para um aplicativo do gerenciador de chaves.
Código principal
Buffer de entrada
O buffer de entrada em > AssociatedIrp.SystemBuffer deve conter uma estrutura GET_BAND_METADATA_PARAMETERS.
Comprimento do buffer de entrada
Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer, que deve ter pelo menos tamanho de (GET_BAND_METADATA_PARAMETERS).
Buffer de saída
O buffer de saída em > AssociatedIrp.SystemBuffer contém uma matriz de bytes de metadados de banda especificada por GET_BAND_METADATA_PARAMETERS.
Comprimento do buffer de saída
O comprimento de uma estrutura GET_BAND_METADATA_PARAMETERS.
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 metadados foram retornados no buffer do sistema. |
| 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 saída está incorreto. |
| STATUS_INVALID_PARAMETER | As informações no buffer de entrada são inválidas. |
| STATUS_NOT_FOUND | A banda não foi encontrada para os critérios de seleção fornecidos. |
| STATUS_IO_DEVICE_ERROR | Falha na comunicação. O dispositivo de armazenamento pode ser incompatível com protocolos de segurança. |
Observações
A autenticação para esse IOCTL é desnecessária e uma chave de autenticação não está incluída como entrada.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8 |
| cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |