DEVICE_DSM_DEFINITION struttura (ntddstor.h)

Articolo
03/05/2024

La struttura DEVICE_DSM_DEFINITION contiene le proprietà per un'azione di gestione del set di dati (DSM).

Sintassi

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;

Members

Action

DeviceDsmDefinition_Xxx valore che specifica l'azione da eseguire. Vedere DEVICE_DSM_ACTION Descrizioni per un elenco di valori di azione e i relativi valori di definizione associati. Questi valori sono definiti in ntddstor.h.

SingleRange

Specifica se l'azione DSM supporta solo un singolo intervallo alla volta. Se l'azione DSM deve essere eseguita sull'intero intervallo di set di dati, viene impostato il flag DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE.

ParameterBlockAlignment

Allineamento per il blocco di parametri all'interno del payload della richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .

ParameterBlockLength

Lunghezza, in byte, del blocco di parametri all'interno del payload della richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Il blocco di parametri seguirà la struttura DSM_DEVICE_INPUT . Se ParameterBlockLength è impostato su zero, il blocco di parametri non esiste.

HasOutput

Impostare TRUE se l'azione specificata nel membro Azione restituirà l'output; in caso contrario, impostare su FALSE.

OutputBlockAlignment

Allineamento per il blocco di output all'interno del payload della richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

OutputBlockLength

Specifica la lunghezza, in byte, del blocco di output all'interno del payload della richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Il blocco di output segue la struttura di DSM_DEVICE_OUTPUT. Se OutputBlockLength è impostato su zero, il blocco di output non esiste.

Commenti

Ogni azione DSM ha una definizione associata a essa. Ad esempio, DeviceDsmAction_Trim ha DeviceDsmDefinition_Trim come definizione associata. Il mittente o il gestore DSM alloca e inizializza la struttura di DEVICE_DSM_DEFINITION con la definizione appropriata. Passano quindi il puntatore a questa struttura a tutte le funzioni correlate al DSM che ne hanno bisogno.

Per informazioni su come viene elaborato un DSM, vedere Panoramica sulla gestione dei set di dati .