IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES IOCTL (ntddstor.h)

Artigo
02/07/2025

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 > AssociatedIrp.SystemBuffer contém uma estrutura DEVICE_DSM_INPUT. Dependendo da ação membro dessa estrutura, o buffer de entrada também pode incluir um bloco de parâmetros e um bloco de intervalos de conjuntos de dados. Consulte DEVICE_DSM_ACTION Descrições 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 tamanho de(DEVICE_DSM_INPUT).

Buffer de saída

Dependendo do valor definido no Action membro do DEVICE_DSM_INPUT, a solicitação pode retornar dados no buffer em >AssociatedIrp.SystemBuffer. O buffer do sistema conterá dados de DEVICE_DSM_OUTPUT válidos se a operação DSM retornar a saída e Parameters.DeviceIoControl.OutputBufferLength> 0. Dependendo do da Ação, o buffer de saída 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á ter pelo menos tamanhos de(DEVICE_DSM_OUTPUT).

Bloco de status

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

Observações

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 no < DISPATCH_LEVEL IRQL.

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