struttura DEVICE_MANAGE_DATA_SET_ATTRIBUTES (ntddstor.h)

La struttura DEVICE_DSM_INPUT (o DEVICE_MANAGE_DATA_SET_ATTRIBUTES) specifica un'azione di gestione per gli attributi del set di dati per un dispositivo.

Sintassi

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

Members

Size

Dimensioni della struttura DEVICE_DSM_INPUT, in byte. Il valore di questo membro verrà modificato man mano che i membri vengono aggiunti alla struttura.

Action

Valore DEVICE_DSM_ACTION che specifica l'azione da eseguire. Per un elenco di valori e descrizioni delle azioni, vedere DEVICE_DSM_ACTION Descrizioni .

Se il flag DeviceDsmActionFlag_NonDestructive (bit più significativo) è impostato in Azione, l'azione specificata non è distruttiva. Per le azioni non distruttive, il driver può inoltrare in modo sicuro la richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES al driver inferiore successivo nello stack anche se il driver non gestisce l'azione specificata. Se il driver gestisce il DSM, deve eseguire la normale elaborazione del blocco di intervalli di set di dati specificato dai membri DataSetRangesOffset e DataSetRangesLength prima di inoltrare la richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES al driver inferiore successivo.

Flags

Questi flag sono globali per tutte le azioni di controllo. Questo membro può essere impostato su uno dei flag seguenti:

Valore flag	Significato
DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE	L'azione di controllo viene specificata per l'intero blocco di intervalli di set di dati. Se questo flag è impostato, i membri DataSetRangesOffset e DataSetRangesLength devono essere impostati su zero.

ParameterBlockOffset

Specifica l'inizio del blocco di parametri all'interno del payload della richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES . Il formato del blocco di parametri dipende dal valore del membro Action . Per altre informazioni sul formato del blocco di parametri, vedere DEVICE_DSM_ACTION Descrizioni. Nota: l'offset del blocco di parametri deve essere allineato al limite dell'indirizzo del parametro corrispondente.

Se ParameterBlockOffset è impostato su zero, il blocco di parametri non esiste.

ParameterBlockLength

Specifica la lunghezza, in byte, del blocco di parametri all'interno del payload della richiesta IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

Se ParameterBlockLength è impostato su zero, il blocco di parametri non esiste.

DataSetRangesOffset

Specifica l'inizio del blocco di intervalli di set di dati all'interno del payload della richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Questo blocco è costituito da una o più voci contigue formattate come strutture DEVICE_DSM_RANGE . Nota: l'offset del blocco di intervallo del set di dati deve essere allineato al limite dell'indirizzo della struttura DEVICE_DSM_RANGE.

Se impostato su zero, il blocco di intervalli di set di dati non esiste.

DataSetRangesLength

Specifica la lunghezza, in byte, del blocco di intervalli di set di dati all'interno del payload della richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Se DataSetRangesLength è impostato su zero, il blocco di intervalli di set di dati non esiste.

Commenti

Per altre informazioni sul formato del payload per una richiesta di IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES , vedere Panoramica sulla gestione dei set di dati. Le dimensioni totali del buffer devono essere almeno sizeof(DEVICE_DSM_INPUT) + ParameterBlockLength + DataSetRangesLength.

Il blocco di intervalli di set di dati viene specificato dai membri DataSetRangesOffset e DataSetRangesLength . Se questo blocco esiste, contiene strutture contigue DEVICE_DSM_RANGE .

Requisiti

Requisito	Valore
Intestazione	ntddstor.h (include Ntddstor.h)

Vedi anche

Panoramica della gestione dei set di dati

descrizioni DEVICE_DSM_ACTION

DEVICE_DSM_RANGE

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES