Share via

estrutura DEVICE_MANAGE_DATA_SET_ATTRIBUTES (winioctl.h)

  • Artigo

Estrutura de entrada para o código de controle IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .

Sintaxe

typedef struct _DEVICE_MANAGE_DATA_SET_ATTRIBUTES {
  DWORD             Size;
  DEVICE_DSM_ACTION Action;
  DWORD             Flags;
  DWORD             ParameterBlockOffset;
  DWORD             ParameterBlockLength;
  DWORD             DataSetRangesOffset;
  DWORD             DataSetRangesLength;
} DEVICE_MANAGE_DATA_SET_ATTRIBUTES, *PDEVICE_MANAGE_DATA_SET_ATTRIBUTES, DEVICE_DSM_INPUT, *PDEVICE_DSM_INPUT;

Membros

Size

Tamanho dessa estrutura de dados. Deve ser definido como sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES).

Action

Um valor válido do tipo DEVICE_DATA_MANAGEMENT_SET_ACTION.

Valor Significado
DeviceDsmAction_Trim
1
 Uma ação de corte é executada. Não há suporte para esse valor para aplicativos no modo de usuário.
DeviceDsmAction_Notification
2 | DeviceDsmActionFlag_NonDestructive (0x80000002)
 Uma ação de notificação é executada. Os parâmetros adicionais estão em uma estrutura DEVICE_DSM_NOTIFICATION_PARAMETERS . O DeviceDsmActionFlag_NonDestructive (0x80000000) é um sinalizador de bits para indicar à pilha de driver que essa operação não é destrutiva.
DeviceDsmAction_OffloadRead
3 | DeviceDsmActionFlag_NonDestructive (0x80000003)
 Uma ação de leitura de descarregamento é executada. Os parâmetros adicionais estão em uma estrutura DEVICE_DSM_OFFLOAD_READ_PARAMETERS . O DeviceDsmActionFlag_NonDestructive (0x80000000) é um sinalizador de bits para indicar à pilha de driver que essa operação não é destrutiva.

Windows 7 e Windows Server 2008 R2: Esse valor não tem suporte antes do Windows 8 e do Windows Server 2012.
DeviceDsmAction_OffloadWrite
4
 Uma ação de gravação de descarregamento é executada. Os parâmetros adicionais estão em uma estrutura DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS .

Windows 7 e Windows Server 2008 R2: Esse valor não tem suporte antes do Windows 8 e do Windows Server 2012.
DeviceDsmAction_Allocation
5 | DeviceDsmActionFlag_NonDestructive (0x80000005)
 Um bitmap de alocação é recuperado para o primeiro intervalo de conjunto de dados especificado. O DeviceDsmActionFlag_NonDestructive (0x80000000) é um sinalizador de bits para indicar à pilha de driver que essa operação não é destrutiva.

Windows 7 e Windows Server 2008 R2: Esse valor não tem suporte antes do Windows 8 e do Windows Server 2012.
DeviceDsmAction_Repair
6 | DeviceDsmActionFlag_NonDestructive (0x80000006)
 Uma ação de reparo é executada. Os parâmetros adicionais estão em uma estrutura DEVICE_DATA_SET_REPAIR_PARAMETERS . O DeviceDsmActionFlag_NonDestructive (0x80000000) é um sinalizador de bits para indicar à pilha de driver que essa operação não é destrutiva.

Windows 7 e Windows Server 2008 R2: Esse valor não tem suporte antes do Windows 8 e do Windows Server 2012.
DeviceDsmAction_Scrub
7 | DeviceDsmActionFlag_NonDestructive (0x80000007)
 Uma ação de limpeza é executada. O DeviceDsmActionFlag_NonDestructive (0x80000000) é um sinalizador de bits para indicar à pilha de driver que essa operação não é destrutiva.

Windows 7 e Windows Server 2008 R2: Esse valor não tem suporte antes do Windows 8 e do Windows Server 2012.
DeviceDsmAction_Resiliency
8 | DeviceDsmActionFlag_NonDestructive (0x80000008)
 Uma ação de resiliência é executada. O DeviceDsmActionFlag_NonDestructive (0x80000000) é um sinalizador de bits para indicar à pilha de driver que essa operação não é destrutiva.

Windows 7 e Windows Server 2008 R2: Esse valor não tem suporte antes do Windows 8 e do Windows Server 2012.

Flags

Sinalizadores para as ações.

Valor Significado
DEVICE_DSM_FLAG_TRIM_NOT_FS_ALLOCATED
0x80000000
 Se definido, os intervalos descritos não serão alocados por um sistema de arquivos. Esse sinalizador é específico para a ação DeviceDsmAction_Trim .
DEVICE_DSM_FLAG_RESILIENCY_START_RESYNC
0x10000000
 Inicia uma operação de ressincronização no dispositivo de armazenamento. Esse sinalizador é específico para a ação DeviceDsmAction_Resiliency .
DEVICE_DSM_FLAG_RESILIENCY_START_LOAD_BALANCING
0x20000000
 Inicia uma operação de balanceamento de carga no dispositivo de armazenamento. Esse sinalizador é específico para a ação DeviceDsmAction_Resiliency .

ParameterBlockOffset

Deslocamento de bytes para o início do bloco de parâmetros armazenado no buffer contíguo a essa estrutura. Deve ser alinhado ao alinhamento da estrutura correspondente. Um valor zero indica que não há nenhum bloco de parâmetro e o membro ParameterBlockLength também deve ser zero.

ParameterBlockLength

Comprimento do bloco de parâmetros, em bytes. Um valor zero indica que não há nenhum bloco de parâmetro e o membro ParameterBlockOffset também deve ser zero.

DataSetRangesOffset

Deslocamento de bytes para o início do bloco de intervalos do conjunto de dados composto por uma matriz de estruturas de DEVICE_DATA_SET_RANGE armazenadas no buffer contíguo a essa estrutura. Deve estar alinhado ao alinhamento da estrutura DEVICE_DATA_SET_RANGE . Um valor zero indica que não há nenhum bloco de intervalos de conjunto de dados e o membro DataSetRangesLength também deve ser zero.

DataSetRangesLength

Comprimento do bloco de intervalos do conjunto de dados, em bytes. Um valor zero indica que não há nenhum bloco de intervalos de conjunto de dados e o membro DataSetRangesOffset também deve ser zero.

Comentários

O comprimento total do buffer que contém essa estrutura deve ser pelo menos (sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES) + ParameterBlockLength + DataSetRangesLength).

Requisitos

   
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

DEVICE_DATA_SET_RANGE

Estruturas de Gerenciamento de Dispositivos

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES