estrutura WNODE_SINGLE_INSTANCE (wmistr.h)

A estrutura WNODE_SINGLE_INSTANCE contém valores para todos os itens de dados em uma instância de um bloco de dados.

Sintaxe

typedef struct tagWNODE_SINGLE_INSTANCE {
  struct _WNODE_HEADER WnodeHeader;
  ULONG                OffsetInstanceName;
  ULONG                InstanceIndex;
  ULONG                DataBlockOffset;
  ULONG                SizeDataBlock;
  UCHAR                VariableData[];
} WNODE_SINGLE_INSTANCE, *PWNODE_SINGLE_INSTANCE;

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 dessa instância, alinhado em um limite 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 de uma instância registrada com nomes de instância estática. Esse membro só será válido se 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.

DataBlockOffset

Indica o deslocamento do início dessa estrutura para o início da instância.

SizeDataBlock

Indica o tamanho do bloco de dados dessa instância.

VariableData

Contém dados adicionais, incluindo o nome da instância dinâmica, se houver, preenchimento para que a instância comece em um limite de 8 bytes e a instância do bloco de dados a ser retornada.

Comentários

O WMI passa um WNODE_SINGLE_INSTANCE com uma solicitação IRP_MN_CHANGE_SINGLE_INSTANCE para definir itens de dados de leitura/gravação em uma instância de um bloco de dados. Um driver pode ignorar valores passados para itens de dados somente leitura na instância.

Um driver preenche um WNODE_SINGLE_INSTANCE em resposta a uma solicitação de IRP_MN_QUERY_SINGLE_INSTANCE ou para gerar um evento que consiste em uma única instância.

Requisitos

Confira também

WNODE_EVENT_ITEM

WNODE_HEADER