Поделиться через


структура WNODE_EVENT_REFERENCE (wmistr.h)

Структура WNODE_EVENT_REFERENCE содержит сведения, которые WMI может использовать для запроса события, превышающего ограничение размера события в реестре.

Синтаксис

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;

Члены

WnodeHeader

Представляет собой структуру WNODE_HEADER, содержащую информацию, общую для всех структур WNODE_XXX, таких как размер буфера, идентификатор поставщика, идентификатор GUID, представляющий блок данных, связанный с запросом, и флаги, предоставляющие сведения о передаваемых или возвращаемых данных WNODE_XXX.

TargetGuid

Указывает GUID, представляющий событие для запроса.

TargetDataBlockSize

Указывает размер события.

DUMMYUNIONNAME

DUMMYUNIONNAME.TargetInstanceIndex

Указывает индекс в список статических экземпляров драйвера для события. Этот элемент действителен, только если блок событий зарегистрирован со статическими именами экземпляров и WNODE_FLAGS_STATIC_INSTANCE_NAMES задан в WnodeHeader.Flags.

DUMMYUNIONNAME.TargetInstanceName

Указывает имя динамического экземпляра события в виде подсчитаной строки Юникода. Этот элемент действителен, только если WNODE_FLAGS_STATIC_INSTANCE_NAMES ясно в WnodeHeader.Flags, а блок событий был зарегистрирован с именами динамических экземпляров.

Замечания

Если объем данных для события превышает максимальный размер, заданный в реестре, драйвер может создать WNODE_EVENT_REFERENCE, указывающий WNODE_EVENT_ITEM, который WMI может запрашивать для получения события. Дополнительные сведения об определении и создании событий WMI см. в реализацииWMI.

Элемент ProviderId структуры WNODE_HEADER для использования в структуре WNODE_EVENT_REFERENCE следует инициализировать с помощью IoWMIDeviceObjectToProviderId.

Требования

Требование Ценность
заголовка wmistr.h (include Wmistr.h)

См. также

IoWMIDeviceObjectToProviderId

WNODE_EVENT_ITEM

WNODE_HEADER