다음을 통해 공유


IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL(ntddstor.h)

드라이버는 IOCTL_STORAGE_REINITIALIZE_MEDIA 제어 코드를 실행하여 삭제 프로세스를 스토리지 디바이스로 오프로드할 수 있습니다.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

Windows Server 2022 이상에서는 삭제 옵션이 있는 선택적 STORAGE_REINITIALIZE_MEDIA 구조체 또는 NULL을 포함합니다. 이전 OS 버전의 경우 입력 버퍼는 NULL입니다.

입력 버퍼 길이

Windows 10 릴리스 21H1 이상에서는 Parameters.DeviceIoControl.InputBufferLengthIrp-AssociatedIrp.SystemBuffer>에서 매개 변수 버퍼의 크기(바이트)를 나타내며, Parameters.DeviceIoControl.InputBuffer != NULL인 경우 = sizeof(STORAGE_REINITIALIZE_MEDIA)여야 합니다. 그렇지 않으면 0입니다>. 이전 OS 버전의 경우 입력 버퍼 길이는 0입니다.

출력 버퍼

없음

출력 버퍼 길이

없음

입력/출력 버퍼

해당 없음

입력/출력 버퍼 길이

해당 없음

상태 블록

호출이 성공적으로 완료되면 정보 필드가 0으로 설정됩니다. 그렇지 않으면 0이 아닌 값으로 설정됩니다.

설명

IOCTL_STORAGE_REINITIALIZE_MEDIA 삭제를 스토리지 디바이스로 오프로드합니다. 명령이 완료된 후 스토리지 디바이스의 데이터를 성공적으로 삭제하거나 복구할 수 있다는 보장은 없습니다.

이 IOCTL은 데스크톱 디바이스 패밀리의 디바이스에 있는 데이터 디스크로 제한됩니다. WinPE(Windows 사전 설치 환경)에서 이 IOCTL은 부팅 및 데이터 디스크 모두에 대해 지원됩니다.

이전 OS 버전에서는 구현에 입력이 필요하지 않으며 상태 이외의 출력을 반환하지 않습니다.

호출자는 먼저 이 IOCTL을 호출하기 전에 FSCTL_LOCK_VOLUME 호출하여 상위 계층에서 캐시된 데이터를 플러시해야 합니다. 디바이스에 명령을 실행하기 전에 미해결 요청 완료 대기가 수행되지 않습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 10 버전 1607
지원되는 최소 서버 Windows Server 2016
머리글 ntddstor.h

추가 정보

IO_STATUS_BLOCK 구조체

STORAGE_REINITIALIZE_MEDIA

디스패치 루틴에서 IRP를 완료하는 방법