IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL(ntddstor.h)

아티클
2025. 02. 07.

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

주 코드

입력 버퍼

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입니다.

출력 버퍼

없음.

출력 버퍼 길이

없음.

입력/출력 버퍼

n/a

입력/출력 버퍼 길이

n/a

상태 블록

호출이 성공적으로 완료되면 정보 필드가 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를 완료하는 방법

다음을 통해 공유