IOCTL_EHSTOR_BANDMGMT_ACTIVATE IOCTL (ehstorbandmgmt.h)

  • Artigo

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

IRP_MJ_DEVICE_CONTROL

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)

Confira também

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_REVERT