DEVICE_DSM_DEFINITION-Struktur (ntddstor.h)

Artikel
02/26/2024

Die DEVICE_DSM_DEFINITION-Struktur enthält die Eigenschaften für eine DsM-Aktion (Data Set Management).

Syntax

typedef struct _DEVICE_DSM_DEFINITION {
  DEVICE_DSM_ACTION Action;
  BOOLEAN           SingleRange;
  ULONG             ParameterBlockAlignment;
  ULONG             ParameterBlockLength;
  BOOLEAN           HasOutput;
  ULONG             OutputBlockAlignment;
  ULONG             OutputBlockLength;
} DEVICE_DSM_DEFINITION, *PDEVICE_DSM_DEFINITION;

Member

Action

DeviceDsmDefinition_Xxx-Wert , der die auszuführende Aktion angibt. Eine Liste der Aktionswerte und der zugehörigen Definitionswerte finden Sie unter DEVICE_DSM_ACTION Beschreibungen . Diese Werte werden in ntddstor.h definiert.

SingleRange

Gibt an, ob die DSM-Aktion jeweils nur einen einzelnen Bereich unterstützt. Wenn die DSM-Aktion für den gesamten Datasetbereich ausgeführt werden soll, wird das Flag DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE festgelegt.

ParameterBlockAlignment

Die Ausrichtung für den Parameterblock innerhalb der Nutzlast der IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES-Anforderung .

ParameterBlockLength

Die Länge des Parameterblocks in Bytes innerhalb der Nutzlast der IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES-Anforderung. Der Parameterblock folgt der DSM_DEVICE_INPUT-Struktur . Wenn ParameterBlockLength auf 0 festgelegt ist, ist der Parameterblock nicht vorhanden.

HasOutput

Legen Sie TRUE fest, wenn die im Action-Member angegebene Aktion eine Ausgabe zurückgibt. Andernfalls legen Sie dies auf FALSE fest.

OutputBlockAlignment

Die Ausrichtung für den Ausgabeblock innerhalb der Nutzlast der IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES-Anforderung.

OutputBlockLength

Gibt die Länge des Ausgabeblocks in Bytes innerhalb der Nutzlast der IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES-Anforderung an. Der Ausgabeblock folgt der DSM_DEVICE_OUTPUT-Struktur. Wenn OutputBlockLength auf 0 festgelegt ist, ist der Ausgabeblock nicht vorhanden.

Hinweise

Jeder DSM-Aktion ist eine Definition zugeordnet. Beispielsweise verfügt DeviceDsmAction_Trimüber DeviceDsmDefinition_Trim als zugeordnete Definition. Der DSM-Absender oder -Handler ordnet die DEVICE_DSM_DEFINITION-Struktur mit der entsprechenden Definition zu und initialisiert sie. Anschließend übergeben sie den Zeiger auf diese Struktur an alle DSM-bezogenen Funktionen, die ihn benötigen.

Informationen zur Verarbeitung eines DSM finden Sie unter Übersicht über die Datasetverwaltung .