IOCTL_STORAGE_SET_PROPERTY IOCTL (ntddstor.h)
Ein Treiber kann IOCTL_STORAGE_SET_PROPERTY verwenden, um die Eigenschaften eines Speichergeräts oder Adapters festzulegen.
Hinweis
Aufgrund kollidierender IOCTL-Definitionen in Windows 10 Version 2004 muss vorhandene Software, die IOCTL_STORAGE_SET_PROPERTY verwendet, unter Windows Server 2022 neu kompiliert werden.
Hauptcode
Eingabepuffer
Enthält eine STORAGE_PROPERTY_SET-Struktur , die den Typ des zu erledigenden Satzes, die festgelegte Eigenschaft und alle zusätzlichen Parameter beschreibt, die ein bestimmter Eigenschaftensatz erfordert. Eine Struktur mit zusätzlichen Eigenschaften kann unmittelbar nach der STORAGE_PROPERTY_SET-Struktur gefunden werden, abhängig von der PropertyId STORAGE_PROPERTY_SET. Wenn PropertyId beispielsweise StorageAdapterProtocolSpecificProperty ist, folgt sofort eine STORAGE_PROTOCOL_SPECIFIC_DATA_EXT-Struktur STORAGE_PROPERTY_SET.
Eingabepufferlänge
Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Parameterpuffers bei Irp-AssociatedIrp.SystemBuffer> in Bytes an, die = sizeof(STORAGE_PROPERTY_SET) sein >muss.
Ausgabepuffer
Hängt von der angegebenen PropertyId ab. Wenn PropertyId beispielsweise StorageAdapterProtocolSpecificProperty ist, enthält der Ausgabepuffer eine STORAGE_PROTOCOL_SPECIFIC_DATA_EXT Struktur mit aktualisierten Daten aus dem Miniport.
Länge des Ausgabepuffers
Größe des Ausgabepuffers in Bytes.
Eingabe-/Ausgabepuffer
–
Länge des Eingabe-/Ausgabepuffers
–
Statusblock
Irp-IoStatus.Status> ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Andernfalls wird status für die entsprechende Fehlerbedingung als NTSTATUS-Code verwendet. Weitere Informationen finden Sie unter NTSTATUS-Werte.
Anforderungen
Anforderung | Wert |
---|---|
Header | ntddstor.h |