IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)

A solicitação IOCTL_EHSTOR_BANDMGMT_ERASE_BAND apaga e redefine criptograficamente a chave de autenticação de uma banda. A configuração restante da banda é deixada sem modificações.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

O buffer de entrada em Irp-AssociatedIrp.SystemBuffer> deve conter um ERASE_BAND_PARAMETERS e possivelmente uma estrutura AUTH_KEY.

Se o membro NewAuthKeyOffset do ERASE_BAND_PARAMETERS estiver definido como EHSTOR_BANDMGR_NO_KEY, os dados de entrada no buffer do sistema não precisarão incluir uma estrutura de AUTH_KEY .

Comprimento do buffer de entrada

Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer, que deve ser pelo menos sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY).

Buffer de saída

Nenhum.

Comprimento do buffer de saída

Nenhum.

Buffer de entrada/saída

Nenhum.

Comprimento do buffer de entrada/saída

Nenhum.

Bloco de status

Um dos valores a seguir pode ser retornado no campo Status .

Valor do status	Descrição
STATUS_SUCCESS	A banda foi apagada com sucesso.
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 está incorreto.
STATUS_INVALID_PARAMETER	As informações no buffer de entrada são inválidas.
STATUS_ACCESS_DENIED	A chave de autenticação de apagamento não é uma chave padrão e a banda não pode ser apagada.
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.

Comentários

Uma chave de autenticação de apagamento atual não é fornecida em uma solicitação IOCTL_EHSTOR_BANDMGMT_ERASE_BAND . A chave de autenticação de apagamento para o dispositivo de armazenamento foi configurada anteriormente.

Nenhum método é fornecido no Windows para alterar a chave de autenticação de apagamento para um dispositivo de armazenamento. Desde que os parâmetros corretos sejam fornecidos como entrada no buffer do sistema, essa solicitação deve ser bem-sucedida. Se a chave de autenticação de apagamento tiver sido alterada fora do Windows, como em um ambiente de inicialização dupla com um sistema operacional diferente, essa solicitação poderá falhar.

Quando uma banda é apagada com IOCTL_EHSTOR_BANDMGMT_ERASE_BAND, as únicas propriedades anteriores que permanecem são o início da banda e o tamanho da banda. A chave de criptografia de mídia anterior é removida e uma nova chave é gerada. O bloqueio é definido como PERSISTANT_UNLOCK para leitura e gravação. Os metadados de segurança definidos anteriormente são apagados. A nova chave de autenticação especificada em ERASE_BAND_PARAMETERS é definida, a menos que o uso da chave padrão seja indicado.

Para impedir que outros aplicativos assumem o controle de uma banda e apaguem usando a chave padrão, uma nova chave de autenticação deve ser incluída na solicitação IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .

As alterações feitas na tabela de banda por essa solicitação são confirmadas no dispositivo atomicamente antes da conclusão da solicitação IOCTL. Portanto, é garantido que a banda seja modificada com todas as suas propriedades definidas ou nenhuma propriedade definida caso ocorra uma falha de energia ou sistema.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Cabeçalho	ehstorbandmgmt.h (inclua EhStorBandMgmt.h)

Confira também

ERASE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS