estrutura DEVICE_DSM_DEFINITION (ntddstor.h)

Artigo
08/07/2023

A estrutura DEVICE_DSM_DEFINITION contém as propriedades de uma ação de DSM (gerenciamento de conjunto de dados).

Sintaxe

typedef struct _DEVICE_DSM_DEFINITION {
  DEVICE_DSM_ACTION Action;
  BOOLEAN           SingleRange;
  ULONG             ParameterBlockAlignment;
  ULONG             ParameterBlockLength;
  BOOLEAN           HasOutput;
  ULONG             OutputBlockAlignment;
  ULONG             OutputBlockLength;
} DEVICE_DSM_DEFINITION, *PDEVICE_DSM_DEFINITION;

Membros

Action

DeviceDsmDefinition_ valorXxx que especifica a ação a ser executada. Consulte DEVICE_DSM_ACTION Descrições para obter uma lista de valores de ação e seus valores de definição associados. Esses valores são definidos em ntddstor.h.

SingleRange

Especifica se a ação DSM dá suporte a apenas um único intervalo por vez. Se a ação DSM for executada em todo o intervalo do conjunto de dados, o sinalizador DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE será definido.

ParameterBlockAlignment

O alinhamento do bloco de parâmetros dentro do conteúdo da solicitação IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .

ParameterBlockLength

O comprimento, em bytes, do bloco de parâmetros dentro do conteúdo da solicitação de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. O bloco de parâmetros seguirá a estrutura DSM_DEVICE_INPUT . Se ParameterBlockLength estiver definido como zero, o bloco de parâmetros não existirá.

HasOutput

Defina TRUE se a ação especificada no membro Action retornar a saída; caso contrário, defina isso como FALSE.

OutputBlockAlignment

O alinhamento do bloco de saída dentro do conteúdo da solicitação de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

OutputBlockLength

Especifica o comprimento, em bytes, do bloco de saída dentro do conteúdo da solicitação IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. O bloco de saída segue a estrutura DSM_DEVICE_OUTPUT. Se OutputBlockLength estiver definido como zero, o bloco de saída não existirá.

Comentários

Cada ação DSM tem uma definição associada a ela. Por exemplo, DeviceDsmAction_Trimtem DeviceDsmDefinition_Trim como sua definição associada. O remetente ou manipulador DSM aloca e inicializa a estrutura DEVICE_DSM_DEFINITION com a definição apropriada. Em seguida, eles passam o ponteiro para essa estrutura para todas as funções relacionadas ao DSM que precisam dela.

Consulte Visão geral do gerenciamento de conjunto de dados para obter informações sobre como um DSM é processado.