IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)
O IOCTL_EHSTOR_BANDMGMT_ERASE_BAND solicitação apaga criptograficamente e redefine a chave de autenticação de uma banda. A configuração restante da banda não é modificada.
Código principal
Buffer de entrada
O buffer de entrada em > AssociatedIrp.SystemBuffer deve conter um ERASE_BAND_PARAMETERS e, possivelmente, uma estrutura AUTH_KEY.
Se o NewAuthKeyOffset membro 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 do.
| Valor do status | Descrição |
|---|---|
| STATUS_SUCCESS | A banda foi apagada com êxito. |
| 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. |
Observações
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 deverá 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 com a 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 |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| cabeçalho | ehstorbandmgmt.h (inclua EhStorBandMgmt.h) |