DEVICE_DSM_DEFINITION 結構 (ntddstor.h)

發行項
03/01/2024

DEVICE_DSM_DEFINITION 結構包含數據集管理 (DSM) 動作的屬性。

語法

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;

成員

Action

DeviceDsmDefinition_Xxx 值，指定要執行的動作。如需動作值及其相關定義值的清單，請參閱 DEVICE_DSM_ACTION描述。這些值定義於 ntddstor.h 中。

SingleRange

指定 DSM 動作一次是否只支援單一範圍。如果要在整個數據集範圍上執行 DSM 動作，則會設定旗標DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE。

ParameterBlockAlignment

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES 要求承載中參數區塊的對齊方式。

ParameterBlockLength

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES要求承載中參數區塊的長度，以位元組為單位。參數區塊會遵循 DSM_DEVICE_INPUT 結構。如果 ParameterBlockLength 設定為零，則參數區塊不存在。

HasOutput

如果動作成員中指定的動作會傳回輸出，請設定 TRUE;否則，請將此設定為 FALSE。

OutputBlockAlignment

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES要求承載內的輸出區塊對齊方式。

OutputBlockLength

指定IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES要求承載內輸出區塊的長度，以位元組為單位。輸出區塊遵循 DSM_DEVICE_OUTPUT結構。如果 OutputBlockLength 設定為零，則輸出區塊不存在。

備註

每個 DSM 動作都有與其相關聯的定義。例如， DeviceDsmAction_TrimDeviceDsmDefinition_Trim做 為其相關聯的定義。 DSM 傳送者或處理程式會配置並初始化具有適當定義的DEVICE_DSM_DEFINITION結構。然後，他們會將此結構的指標傳遞至所有需要它的 DSM 相關函式。

如需 DSM 處理方式的相關信息，請參閱數據集管理概觀。