IOCTL_STORAGE_REINITIALIZE_MEDIA IOCTL (ntddstor.h)
Ein Treiber kann einen IOCTL_STORAGE_REINITIALIZE_MEDIA Steuercode ausgeben, um den Löschvorgang auf das Speichergerät zu entladen.
Hauptcode
Eingabepuffer
Für Windows Server 2022 und höher enthält eine optionale STORAGE_REINITIALIZE_MEDIA Struktur mit Bereinigungsoptionen oder NULL. Bei früheren Betriebssystemversionen ist der Eingabepuffer NULL.
Eingabepufferlänge
Für Windows 10 Release 21H1 und höher gibt Parameters.DeviceIoControl.InputBufferLength die Größe des Parameterpuffers bei Irp->AssociatedIrp.SystemBufferan, das >= sizeof(STORAGE_REINITIALIZE_MEDIA) sein muss, wenn Parameters.DeviceIoControl.InputBuffer != NULL; andernfalls 0. Bei früheren Betriebssystemversionen ist die Länge des Eingabepuffers null.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Eingabe-/Ausgabepuffer
n/a
Länge des Eingabe-/Ausgabepuffers
n/a
Statusblock
Das Feld Information wird auf Null festgelegt, wenn der Aufruf erfolgreich abgeschlossen wird; andernfalls wird sie auf einen Wert ungleich Null festgelegt.
Bemerkungen
IOCTL_STORAGE_REINITIALIZE_MEDIA die Löschung auf das Speichergerät auslagern. Es besteht keine Garantie für die erfolgreiche Löschung oder Wiederherstellbarkeit der Daten des Speichergeräts nach Abschluss des Befehls.
Diese IOCTL ist auf Datenträger auf Geräten in der Desktopgerätefamilie beschränkt. In Windows Preinstallation Environment (WinPE) wird diese IOCTL sowohl für Startdatenträger als auch für Datenträger unterstützt.
In früheren Betriebssystemversionen erfordert die Implementierung keine Eingabe und gibt keine andere Ausgabe als den Status zurück.
Anrufer sollten zuerst FSCTL_LOCK_VOLUME aufrufen, bevor Sie diese IOCTL aufrufen, um zwischengespeicherte Daten in oberen Ebenen zu leeren. Es wird kein Warten auf den Abschluss der ausstehenden Anforderung ausgeführt, bevor der Befehl auf das Gerät ausgestellt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1607 |
| mindestens unterstützte Server- | Windows Server 2016 |
| Header- | ntddstor.h |