IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)
Um driver pode emitir um código de controle IOCTL_STORAGE_REINITIALIZE_MEDIA para descarregar o processo de eliminação para o dispositivo de armazenamento.
Código principal
Buffer de entrada
Para o Windows Server 2022 e posterior, contém uma estrutura de STORAGE_REINITIALIZE_MEDIA opcional com opções de limpeza ou NULL. Para versões anteriores do sistema operacional, o buffer de entrada é NULL.
Comprimento do buffer de entrada
Para Windows 10 versão 21H1 e posterior, Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer de parâmetro em Irp-AssociatedIrp.SystemBuffer>, que deve ser >= sizeof(STORAGE_REINITIALIZE_MEDIA) se Parameters.DeviceIoControl.InputBuffer != NULL; caso contrário, zero. Para versões anteriores do sistema operacional, o comprimento do buffer de entrada é zero.
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Buffer de entrada/saída
n/d
Comprimento do buffer de entrada/saída
n/d
Bloco de status
O campo Informações será definido como zero se a chamada for concluída com êxito; caso contrário, ele será definido como um valor diferente de zero.
Comentários
IOCTL_STORAGE_REINITIALIZE_MEDIA descarrega a eliminação para o dispositivo de armazenamento. Não há nenhuma garantia quanto à exclusão bem-sucedida ou à capacidade de recuperação dos dados do dispositivo de armazenamento após a conclusão do comando.
Esse IOCTL é limitado a discos de dados em dispositivos na família de dispositivos da área de trabalho. No WinPE (Ambiente de Pré-Instalação do Windows), esse IOCTL tem suporte para discos de inicialização e de dados.
Em versões anteriores do sistema operacional, a implementação não requer entrada e não retorna nenhuma saída diferente de status.
Os chamadores devem primeiro chamar FSCTL_LOCK_VOLUME antes de chamar esse IOCTL para liberar dados armazenados em cache em camadas superiores. Não é possível aguardar a conclusão da solicitação pendente antes de emitir o comando para o dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1607 |
| Servidor mínimo com suporte | Windows Server 2016 |
| Cabeçalho | ntddstor.h |