estrutura WNODE_EVENT_REFERENCE (wmistr.h)

  • Artigo

A estrutura WNODE_EVENT_REFERENCE contém informações que o WMI pode usar para consultar um evento que excede o limite de tamanho do evento definido no Registro.

Sintaxe

typedef struct tagWNODE_EVENT_REFERENCE {
  struct _WNODE_HEADER WnodeHeader;
  GUID                 TargetGuid;
  ULONG                TargetDataBlockSize;
  union {
    ULONG TargetInstanceIndex;
    WCHAR TargetInstanceName[];
  } DUMMYUNIONNAME;
} WNODE_EVENT_REFERENCE, *PWNODE_EVENT_REFERENCE;

Membros

WnodeHeader

É uma estrutura WNODE_HEADER que contém informações comuns a todas as estruturas WNODE_XXX , como o tamanho do buffer, a ID do provedor, o GUID que representa um bloco de dados associado a uma solicitação e sinalizadores que fornecem informações sobre os dados WNODE_XXX que estão sendo passados ou retornados.

TargetGuid

Indica o GUID que representa o evento a ser consultado.

TargetDataBlockSize

Indica o tamanho do evento.

DUMMYUNIONNAME

DUMMYUNIONNAME.TargetInstanceIndex

Indica o índice na lista de nomes de instância estática do driver para o evento. Esse membro só será válido se o bloco de eventos tiver sido registrado com nomes de instância estáticos e WNODE_FLAGS_STATIC_INSTANCE_NAMES estiver definido em WnodeHeader.Flags.

DUMMYUNIONNAME.TargetInstanceName

Indica o nome da instância dinâmica do evento como uma cadeia de caracteres Unicode contada. Esse membro só será válido se WNODE_FLAGS_STATIC_INSTANCE_NAMES estiver claro em WnodeHeader.Flags e o bloco de eventos tiver sido registrado com nomes de instância dinâmica.

Comentários

Se a quantidade de dados de um evento exceder o tamanho máximo definido no registro, um driver poderá gerar um WNODE_EVENT_REFERENCE que especifica um WNODE_EVENT_ITEM que o WMI pode consultar para obter o evento. Para obter mais informações sobre como definir e gerar eventos WMI, consulte Implementando o WMI.

O membro ProviderId da estrutura WNODE_HEADER para uso em uma estrutura WNODE_EVENT_REFERENCE deve ser inicializado usando IoWMIDeviceObjectToProviderId.

Requisitos

Requisito Valor
Cabeçalho wmistr.h (inclua Wmistr.h)

Confira também

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER