IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES IOCTL (ntddstor.h)

Articolo
02/26/2024

Questa richiesta IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES viene usata per inviare una richiesta di gestione del set di dati a un dispositivo di archiviazione.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il buffer in Irp-AssociatedIrp.SystemBuffer> contiene una struttura DEVICE_DSM_INPUT. A seconda del membro Action di questa struttura, il buffer di input potrebbe includere anche un blocco di parametri e un blocco di intervalli di set di dati. Vedere DEVICE_DSM_ACTION Descrizioni per le descrizioni di tutte le azioni possibili.

Lunghezza del buffer di input

Parameters.DeviceIoControl.InputBufferLength nella posizione dello stack I/O dell'IRP indica le dimensioni, in byte, del buffer, che devono essere almeno sizeof(DEVICE_DSM_INPUT).

Buffer di output

A seconda del valore impostato nel membro Action di DEVICE_DSM_INPUT, la richiesta può restituire dati nel buffer in Irp-AssociatedIrp.SystemBuffer>. Il buffer di sistema conterrà dati validi DEVICE_DSM_OUTPUT se l'operazione DSM restituisce output e Parameters.DeviceIoControl.OutputBufferLength> 0. A seconda dell'azione, il buffer di output potrebbe includere anche un blocco di output.

Lunghezza del buffer di output

Lunghezza in byte del buffer di output, se presente. Se viene restituito l'output, il buffer di output deve essere almeno sizeof(DEVICE_DSM_OUTPUT).

Blocco dello stato

Il campo Stato può essere impostato su STATUS_SUCCESS o su STATUS_INVALID_DEVICE_REQUEST, STATUS_BUFFER_TOO_SMALL, STATUS_BUFFER_OVERFLOW o un altro stato di errore.

Commenti

A causa dei requisiti del pool di memoria dallo stack di driver di archiviazione, il completamento dell'IRP contenente questo IOCTL deve essere all'DISPATCH_LEVEL IRQL < .

Per altre informazioni, vedere Panoramica sulla gestione dei set di dati .