Freigeben über


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

IRP_MJ_DEVICE_CONTROL

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

Weitere Informationen

STORAGE_PROPERTY_SET

STORAGE_PROTOCOL_SPECIFIC_DATA_EXT

STORAGE_SET_TYPE