IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES IOCTL (ntddstor.h)

Artigo
08/07/2023

Essa solicitação IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES é usada para enviar uma solicitação de gerenciamento de conjunto de dados para um dispositivo de armazenamento.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

O buffer em Irp-AssociatedIrp.SystemBuffer> contém uma estrutura DEVICE_DSM_INPUT. Dependendo do membro Action dessa estrutura, o buffer de entrada também pode incluir um bloco de parâmetros e um bloco de intervalos de conjunto de dados. Consulte descrições de DEVICE_DSM_ACTION para obter descrições de todas as ações possíveis.

Comprimento do buffer de entrada

Parameters.DeviceIoControl.InputBufferLength no local da pilha de E/S do IRP indica o tamanho, em bytes, do buffer, que deve ser pelo menos sizeof(DEVICE_DSM_INPUT).

Buffer de saída

Dependendo do valor definido no membro Action de DEVICE_DSM_INPUT, a solicitação pode retornar dados no buffer em Irp-AssociatedIrp.SystemBuffer>. O buffer do sistema conterá dados válidos DEVICE_DSM_OUTPUT se a operação DSM retornar a saída e Parameters.DeviceIoControl.OutputBufferLength> 0. Dependendo da Ação, o buffer de saída também pode incluir um bloco de saída.

Comprimento do buffer de saída

O comprimento em bytes do buffer de saída, se houver. Se a saída for retornada, o buffer de saída deverá ser pelo menos sizeof(DEVICE_DSM_OUTPUT).

Bloco de status

O campo Status pode ser definido como STATUS_SUCCESS ou possivelmente para STATUS_INVALID_DEVICE_REQUEST, STATUS_BUFFER_TOO_SMALL, STATUS_BUFFER_OVERFLOW ou algum outro erro status.

Comentários

Devido aos requisitos do pool de memória pela pilha do driver de armazenamento, a conclusão do IRP que contém esse IOCTL deve estar em IRQL < DISPATCH_LEVEL.

Confira Visão geral do gerenciamento de conjunto de dados para obter mais informações.