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) |