DEVICE_DSM_DEFINITION Struktur (ntddstor.h)

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;

Angehörige

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.hdefiniert.

SingleRange

Gibt an, ob die DSM-Aktion jeweils nur einen einzelnen Bereich unterstützt. Wenn die DSM-Aktion für den gesamten Datensatzbereich ausgeführt werden soll, wird das Kennzeichen 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 Null festgelegt ist, ist der Parameterblock nicht vorhanden.

HasOutput

True festlegen, wenn die im Action Member angegebene Aktion 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 Null festgelegt ist, ist der Ausgabeblock nicht vorhanden.

Bemerkungen

Jeder DSM-Aktion ist eine Definition zugeordnet. Beispielsweise weist DeviceDsmAction_TrimDeviceDsmDefinition_Trim als zugehörige Definition auf. Der DSM-Absender oder -Handler weist die DEVICE_DSM_DEFINITION Struktur mit der entsprechenden Definition zu und initialisiert sie. Anschließend übergeben sie den Zeiger an diese Struktur an alle DSM-bezogenen Funktionen, die ihn benötigen.

Unter Data Set Management Overview finden Sie Informationen dazu, wie ein DSM verarbeitet wird.

Anforderungen

Siehe auch

übersicht über Data Set Management

DEVICE_DSM_ACTION Beschreibungen

DSM_DEVICE_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES