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 apagamento no 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 o Windows 10 versão 21H1 e posterior, Parameters.DeviceIoControl.InputBufferLength indica o tamanho, em bytes, do buffer de parâmetro em >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/a
Comprimento do buffer de entrada/saída
n/a
Bloco de status
O campo informações de será definido como zero se a chamada for concluída com êxito; caso contrário, ele será definido como um valor diferente de zero.
Observações
IOCTL_STORAGE_REINITIALIZE_MEDIA descarrega a eliminação para o dispositivo de armazenamento. Não há 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 que não seja o status.
Os chamadores devem primeiro chamar FSCTL_LOCK_VOLUME antes de chamar esse IOCTL para liberar dados armazenados em cache em camadas superiores. Nenhuma espera de conclusão de solicitação pendente é feita antes de emitir o comando para o dispositivo.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 1607 |
| servidor com suporte mínimo | Windows Server 2016 |
| cabeçalho | ntddstor.h |
Consulte também
estrutura IO_STATUS_BLOCK