estrutura WNODE_SINGLE_ITEM (wmistr.h)

A estrutura WNODE_SINGLE_ITEM contém o valor de um único item de dados em uma instância de um bloco de dados.

Sintaxe

typedef struct tagWNODE_SINGLE_ITEM {
  struct _WNODE_HEADER WnodeHeader;
  ULONG                OffsetInstanceName;
  ULONG                InstanceIndex;
  ULONG                ItemId;
  ULONG                DataBlockOffset;
  ULONG                SizeDataItem;
  UCHAR                VariableData[];
} WNODE_SINGLE_ITEM, *PWNODE_SINGLE_ITEM;

Membros

WnodeHeader

É uma estrutura WNODE_HEADER que contém informações comuns a todas as estruturas WNODE_XXX , como o tamanho do buffer, 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.

OffsetInstanceName

Indica o deslocamento do início dessa estrutura para o nome da instância dinâmica, se houver, alinhado em um limite do USHORT. Esse membro só será válido se WNODE_FLAG_STATIC_INSTANCE_NAMES estiver claro em WnodeHeader.Flags. Se o bloco de dados tiver sido registrado com nomes de instância estática, o WMI ignorará OffsetInstanceName.

InstanceIndex

Indica o índice na lista de nomes de instância estática do driver dessa instância. Esse membro só será válido se o bloco de dados tiver sido registrado com nomes de instância estáticos e WNODE_FLAG_STATIC_INSTANCE_NAMES estiver definido em WnodeHeader.Flags. Se o bloco de dados tiver sido registrado com nomes de instância dinâmica, o WMI ignorará InstanceIndex.

ItemId

Especifica a ID do item de dados a ser definido.

DataBlockOffset

Indica o deslocamento do início dessa estrutura para o novo valor do item de dados.

SizeDataItem

Indica o tamanho do item de dados.

VariableData

Contém dados adicionais, incluindo o nome da instância dinâmica, se houver, preenchimento para que o valor de dados comece em um limite de 8 bytes e o novo valor para o item de dados.

Comentários

O WMI passa um WNODE_SINGLE_ITEM com uma solicitação IRP_MN_CHANGE_SINGLE_ITEM para definir o valor de um item de dados em uma instância de um bloco de dados.

Um driver cria uma WNODE_SINGLE_ITEM para gerar um evento que consiste em um único item de dados.

Requisitos

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

Confira também

WNODE_EVENT_ITEM

WNODE_HEADER