DEVICE_MANAGE_DATA_SET_ATTRIBUTES-Struktur (winioctl.h)

Artikel
08/27/2023

Eingabestruktur für den IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES-Steuerelementcode .

Syntax

typedef struct _DEVICE_MANAGE_DATA_SET_ATTRIBUTES {
  DWORD             Size;
  DEVICE_DSM_ACTION Action;
  DWORD             Flags;
  DWORD             ParameterBlockOffset;
  DWORD             ParameterBlockLength;
  DWORD             DataSetRangesOffset;
  DWORD             DataSetRangesLength;
} DEVICE_MANAGE_DATA_SET_ATTRIBUTES, *PDEVICE_MANAGE_DATA_SET_ATTRIBUTES, DEVICE_DSM_INPUT, *PDEVICE_DSM_INPUT;

Member

Size

Größe dieser Datenstruktur. Muss auf sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES) festgelegt sein.

Action

Ein gültiger Wert vom Typ DEVICE_DATA_MANAGEMENT_SET_ACTION.

Wert	Bedeutung
DeviceDsmAction_Trim 1	Es wird eine Kürzungsaktion ausgeführt. Dieser Wert wird für Benutzermodusanwendungen nicht unterstützt.
DeviceDsmAction_Notification 2 \| DeviceDsmActionFlag_NonDestructive (0x80000002)	Es wird eine Benachrichtigungsaktion ausgeführt. Die zusätzlichen Parameter befinden sich in einer DEVICE_DSM_NOTIFICATION_PARAMETERS-Struktur . Die DeviceDsmActionFlag_NonDestructive (0x80000000) ist ein Bitflag, um dem Treiberstapel anzuzeigen, dass dieser Vorgang nicht destruktiv ist.
DeviceDsmAction_OffloadRead 3 \| DeviceDsmActionFlag_NonDestructive (0x80000003)	Es wird eine Offload-Leseaktion ausgeführt. Die zusätzlichen Parameter befinden sich in einer DEVICE_DSM_OFFLOAD_READ_PARAMETERS-Struktur . Die DeviceDsmActionFlag_NonDestructive (0x80000000) ist ein Bitflag, um dem Treiberstapel anzuzeigen, dass dieser Vorgang nicht destruktiv ist. Windows 7 und Windows Server 2008 R2: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
DeviceDsmAction_OffloadWrite 4	Es wird eine Schreibaktion ausgelagert. Die zusätzlichen Parameter befinden sich in einer DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS-Struktur . Windows 7 und Windows Server 2008 R2: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
DeviceDsmAction_Allocation 5 \| DeviceDsmActionFlag_NonDestructive (0x80000005)	Für den ersten angegebenen Datasetbereich wird eine Zuordnungsbitbit abgerufen. Die DeviceDsmActionFlag_NonDestructive (0x80000000) ist ein Bitflag, um dem Treiberstapel anzuzeigen, dass dieser Vorgang nicht destruktiv ist. Windows 7 und Windows Server 2008 R2: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
DeviceDsmAction_Repair 6 \| DeviceDsmActionFlag_NonDestructive (0x80000006)	Es wird eine Reparaturaktion ausgeführt. Die zusätzlichen Parameter befinden sich in einer DEVICE_DATA_SET_REPAIR_PARAMETERS-Struktur . Die DeviceDsmActionFlag_NonDestructive (0x80000000) ist ein Bitflag, um dem Treiberstapel anzuzeigen, dass dieser Vorgang nicht destruktiv ist. Windows 7 und Windows Server 2008 R2: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
DeviceDsmAction_Scrub 7 \| DeviceDsmActionFlag_NonDestructive (0x80000007)	Es wird eine Scrub-Aktion ausgeführt. Die DeviceDsmActionFlag_NonDestructive (0x80000000) ist ein Bitflag, um dem Treiberstapel anzuzeigen, dass dieser Vorgang nicht destruktiv ist. Windows 7 und Windows Server 2008 R2: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.
DeviceDsmAction_Resiliency 8 \| DeviceDsmActionFlag_NonDestructive (0x80000008)	Es wird eine Resilienzaktion ausgeführt. Die DeviceDsmActionFlag_NonDestructive (0x80000000) ist ein Bitflag, um dem Treiberstapel anzuzeigen, dass dieser Vorgang nicht destruktiv ist. Windows 7 und Windows Server 2008 R2: Dieser Wert wird vor Windows 8 und Windows Server 2012 nicht unterstützt.

Flags

Flags für die Aktionen.

Wert	Bedeutung
DEVICE_DSM_FLAG_TRIM_NOT_FS_ALLOCATED 0x80000000	Wenn festgelegt, werden die beschriebenen Bereiche nicht von einem Dateisystem zugeordnet. Dieses Flag ist spezifisch für die DeviceDsmAction_Trim-Aktion .
DEVICE_DSM_FLAG_RESILIENCY_START_RESYNC 0x10000000	Startet einen Neusynchronisierungsvorgang auf dem Speichergerät. Dieses Flag ist spezifisch für die DeviceDsmAction_Resiliency-Aktion .
DEVICE_DSM_FLAG_RESILIENCY_START_LOAD_BALANCING 0x20000000	Startet einen Lastenausgleichsvorgang auf dem Speichergerät. Dieses Flag ist spezifisch für die DeviceDsmAction_Resiliency-Aktion .

ParameterBlockOffset

Byteoffset auf den Anfang des Parameterblocks, der im Puffer gespeichert ist, der an diese Struktur angrenzend ist. Muss an der entsprechenden Strukturausrichtung ausgerichtet werden. Der Wert 0 gibt an, dass kein Parameterblock vorhanden ist, und das ParameterBlockLength-Element muss ebenfalls 0 sein.

ParameterBlockLength

Länge des Parameterblocks in Bytes. Der Wert 0 gibt an, dass kein Parameterblock vorhanden ist, und das ParameterBlockOffset-Element muss ebenfalls 0 sein.

DataSetRangesOffset

Byteoffset zum Anfang des Datasetbereichsblocks, der aus einem Array von DEVICE_DATA_SET_RANGE Strukturen besteht, die im Puffer gespeichert sind, der an diese Struktur angrenzend ist. Muss an der DEVICE_DATA_SET_RANGE Strukturausrichtung ausgerichtet werden. Der Wert 0 gibt an, dass kein Datensatzbereichsblock vorhanden ist, und das DataSetRangesLength-Element muss ebenfalls 0 sein.

DataSetRangesLength

Länge des Datasetbereichblocks in Bytes. Der Wert 0 gibt an, dass kein Datasetbereichsblock vorhanden ist, und das DataSetRangesOffset-Element muss ebenfalls 0 sein.

Hinweise

Die Gesamtlänge des Puffers, der diese Struktur enthält, muss mindestens (sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES) + ParameterBlockLength + DataSetRangesLength)sein.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Kopfzeile	winioctl.h (einschließlich Windows.h)

Weitere Informationen

DEVICE_DATA_SET_RANGE

Geräteverwaltung Strukturen

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES

Freigeben über