Bagikan melalui


IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)

Driver dapat mengeluarkan kode kontrol IOCTL_STORAGE_REINITIALIZE_MEDIA untuk membongkar proses penghapusan ke perangkat penyimpanan.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Untuk Windows Server 2022 dan yang lebih baru, berisi struktur STORAGE_REINITIALIZE_MEDIA opsional dengan opsi sanitasi, atau NULL. Untuk versi OS yang lebih lama, buffer input adalah NULL.

Panjang buffer input

Untuk rilis Windows 10 21H1 dan yang lebih baru, Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer parameter di Irp-AssociatedIrp.SystemBuffer>, yang harus >= sizeof(STORAGE_REINITIALIZE_MEDIA) jika Parameters.DeviceIoControl.InputBuffer != NULL; jika tidak nol. Untuk versi OS sebelumnya, panjang buffer input adalah nol.

Buffer output

Tidak ada.

Panjang buffer output

Tidak ada.

Buffer Input/Output

n/a

Panjang buffer Input/Output

n/a

Blok status

Bidang Informasi diatur ke nol jika panggilan berhasil diselesaikan; jika tidak, itu diatur ke nilai bukan nol.

Keterangan

IOCTL_STORAGE_REINITIALIZE_MEDIA membongkar penghapusan ke perangkat penyimpanan. Tidak ada jaminan tentang keberhasilan penghapusan atau pemulihan data perangkat penyimpanan setelah perintah selesai.

IOCTL ini terbatas pada disk data pada perangkat dalam keluarga perangkat desktop. Di Windows Preinstallation Environment (WinPE), IOCTL ini didukung untuk disk boot dan data.

Dalam versi OS sebelumnya, implementasi tidak memerlukan input dan tidak mengembalikan output selain status.

Penelepon harus terlebih dahulu memanggil FSCTL_LOCK_VOLUME sebelum memanggil IOCTL ini untuk menghapus data cache di lapisan atas. Tidak menunggu penyelesaian permintaan yang luar biasa dilakukan sebelum mengeluarkan perintah ke perangkat.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, version 1607
Server minimum yang didukung Server Windows 2016
Header ntddstor.h

Lihat juga

struktur IO_STATUS_BLOCK

STORAGE_REINITIALIZE_MEDIA

Cara Menyelesaikan IRP dalam Rutinitas Pengiriman