DEVICE_MANAGE_DATA_SET_ATTRIBUTES-Struktur (winioctl.h)

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