IOCTL_EHSTOR_BANDMGMT_ACTIVATE IOCTL (ehstorbandmgmt.h)
Essa solicitação IOCTL_EHSTOR_BANDMGMT_ACTIVATE é enviada para ativar os recursos de segurança e o gerenciamento de banda em um dispositivo de armazenamento. A solicitação inclui opções de ativação e a chave de autenticação.
Código principal
Buffer de entrada
O buffer de entrada em Irp-AssociatedIrp.SystemBuffer> contém uma estrutura ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS é declarado em ehstorbandmgmt.h como o seguinte.
typedef struct _ACTIVATE_REVERT_PARAMETERS
{
ULONG StructSize;
ULONG Flags;
ULONG AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;
A ACTIVATE_REVERT_PARAMETERS seguinte no buffer do sistema é uma estrutura AUTH_KEY . Isso contém os bytes de dados de chave para a chave de autenticação. AUTH_KEY é declarado em ehstorbandmgmt.h como o seguinte.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
Comprimento do buffer de entrada
O comprimento de uma estrutura ACTIVATE_REVERT_PARAMETERS .
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Bloco de status
Um dos valores a seguir pode ser retornado no campo Status .
| Valor do status | Descrição |
|---|---|
| STATUS_SUCCESS | Os recursos de segurança no dispositivo de armazenamento foram ativados. |
| 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_ACCESS_DENIED | A chave de autenticação é inválida. A ativação foi negada. |
| STATUS_DEVICE_CONFIGURATION_ERROR | O sistema não pode configurar o dispositivo em um modo com suporte. |
| STATUS_IO_DEVICE_ERROR | Falha na comunicação. O dispositivo de armazenamento pode ser incompatível com protocolos de segurança. |
| STATUS_INVALID_DEVICE_STATE | O dispositivo de armazenamento já está ativado. |
| STATUS_NOT_SUPPORTED | Os recursos de segurança no dispositivo não foram ativados devido a uma configuração de Política de Grupo. |
Comentários
Se STATUS_SUCCESS for retornado dessa solicitação, um driver ou aplicativo poderá enviar uma solicitação IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES para recuperar os recursos de gerenciamento de banda habilitados do dispositivo.
Antes de um retorno bem-sucedido do IOCTL_EHSTOR_BANDMGMT_ACTIVATE, o dispositivo não é ativado. Até que o dispositivo seja ativado, o único IOCTL de gerenciamento de banda que retornará com êxito é IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES. Após a ativação, os IOCTLs de gerenciamento de banda restantes estão disponíveis.
A ativação de dispositivos de Armazenamento Avançado é controlada pelas configurações de Política de Grupo do sistema. O valor do registro em HKLM\Software\Policies\Microsoft\Windows\EnhancedStorageDevices\TCGSecurityActivationDisabled determina se a ativação de segurança está habilitada. Um valor de REG_DWORD de 0 permite a ativação de segurança no dispositivo de armazenamento. Caso contrário, um valor 1 desabilita a ativação de segurança e a solicitação IOCTL_EHSTOR_BANDMGMT_ACTIVATE retornará com STATUS_NOT_SUPPORTED.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8. |
| Cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |