DEVICE_DSM_NOTIFICATION_PARAMETERS estrutura (ntddstor.h)

A estrutura DEVICE_DSM_NOTIFICATION_PARAMETERS especifica os parâmetros de uma operação de notificação relacionada aos atributos de conjunto de dados de um dispositivo.

Sintaxe

typedef struct _DEVICE_DSM_NOTIFICATION_PARAMETERS {
  ULONG Size;
  ULONG Flags;
  ULONG NumFileTypeIDs;
  GUID  FileTypeID[ANYSIZE_ARRAY];
} DEVICE_DSM_NOTIFICATION_PARAMETERS, *PDEVICE_DSM_NOTIFICATION_PARAMETERS;

Membros

Size

O tamanho total, em bytes, dessa estrutura. O valor desse membro deve incluir o tamanho total, em bytes, do membro FileTypeID.

Flags

Um sinalizador que especifica as características da operação de notificação. O membro sinalizadores de deve ser definido como um dos seguintes valores:

Bandeira	Significado
DEVICE_DSM_NOTIFY_FLAG_BEGIN	O intervalo lba (endereço de bloco lógico) está sendo usado atualmente pelos tipos de arquivo especificados no membro FileTypeID. O intervalo LBA é especificado pelo intervalo do conjunto de dados dentro do conteúdo de uma solicitação de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.
DEVICE_DSM_NOTIFY_FLAG_END	O intervalo LBA não está mais sendo usado pelos tipos de arquivo especificados no membro FileTypeID.

NumFileTypeIDs

O número de entradas no membro FileTypeID.

FileTypeID[ANYSIZE_ARRAY]

Um ou mais GUID valores que especificam o tipo de arquivo para a operação de notificação. A tabela a seguir descreve os valores FileTypeID GUID.

Valor do GUID	Descrição
FILE_TYPE_NOTIFICATION_GUID_PAGE_FILE	Especifica uma operação de notificação para um arquivo de página.
FILE_TYPE_NOTIFICATION_GUID_HIBERNATION_FILE	Especifica uma operação de notificação para o arquivo de hibernação do sistema.
FILE_TYPE_NOTIFICATION_GUID_CRASHDUMP_FILE	Especifica uma operação de notificação para um arquivo de despejo de falha do sistema.

Observações

A notificação é especificada no bloco de parâmetros dentro do conteúdo de uma solicitação IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Consulte Visão geral do gerenciamento de conjunto de dados para obter uma descrição geral do layout de conteúdo.

A partir do Windows 7, o sistema de arquivos NTFS notifica a pilha de armazenamento quando o intervalo do conjunto de dados LBA (endereçamento de bloco lógico) é alterado para um conjunto especificado de arquivos. O sistema de arquivos emite essa notificação enviando à pilha de armazenamento uma solicitação IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES com um buffer do sistema que contém uma estrutura DEVICE_DSM_INPUT. Para a operação de notificação, o sistema de arquivos define os membros da estrutura DEVICE_DSM_INPUT da seguinte maneira:

• O membro da Ação está definido como DeviceDsmAction_Notification.
• Os membros ParameterBlockOffset e ParameterBlockLength especificam o local e o tamanho do bloco de parâmetros para a operação de notificação. O bloco de parâmetros é formatado como uma estrutura DEVICE_DSM_NOTIFICATION_PARAMETERS.
• Se o membro sinalizadores do estiver definido como zero, os membros DataSetRangesOffset e DataSetRangesLength especificar o bloco de intervalo do conjunto de dados dentro do conteúdo IOCTL.
• Se o Flags membro estiver definido como DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE, o dataSetRangesOffset e membros DataSetRangesLength serão definidos como zero e a ação de notificação incluirá todo o intervalo de conjunto de dados para os arquivos especificados.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7
servidor com suporte mínimo	Windows Server 2008 R2
cabeçalho	ntddstor.h (include Ntddstor.h)

Consulte também

Visão geral do gerenciamento do conjunto de dados

Descrições de DEVICE_DSM_ACTION

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES