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 auszulagern.
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.
Länge des Eingabepuffers
Für Windows 10 Release 21H1 und höher gibt Parameters.DeviceIoControl.InputBufferLength die Größe des Parameterpuffers bei Irp-AssociatedIrp.SystemBuffer> in Byte an, die = sizeof(STORAGE_REINITIALIZE_MEDIA) sein >muss, wenn Parameters.DeviceIoControl.InputBuffer != NULL; andernfalls Null. Bei früheren Betriebssystemversionen ist die Länge des Eingabepuffers null.
Ausgabepuffer
Keine.
Länge des Ausgabepuffers
Keine.
Eingabe-/Ausgabepuffer
–
Länge des Eingabe-/Ausgabepuffers
–
Statusblock
Das Feld Information wird auf 0 (null) festgelegt, wenn der Aufruf erfolgreich abgeschlossen wird. Andernfalls wird er auf einen Wert ungleich 0 festgelegt.
Hinweise
IOCTL_STORAGE_REINITIALIZE_MEDIA die Löschung auf das Speichergerät aus. Es gibt 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 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 status zurück.
Aufrufer sollten zuerst FSCTL_LOCK_VOLUME aufrufen, bevor diese IOCTL aufgerufen wird, um zwischengespeicherte Daten in den oberen Ebenen auszuleeren. Es wird nicht auf den Abschluss der ausstehenden Anforderung gewartet, bevor der Befehl an das Gerät ausgegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1607 |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Kopfzeile | ntddstor.h |