WDF_WMI_INSTANCE_CONFIG-Struktur (wdfwmi.h)

[Gilt nur für KMDF]

Die WDF_WMI_INSTANCE_CONFIG-Struktur enthält Konfigurationsinformationen für eine instance eines WMI-Datenanbieters.

Syntax

typedef struct _WDF_WMI_INSTANCE_CONFIG {
  ULONG                               Size;
  WDFWMIPROVIDER                      Provider;
  PWDF_WMI_PROVIDER_CONFIG            ProviderConfig;
  BOOLEAN                             UseContextForQuery;
  BOOLEAN                             Register;
  PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE EvtWmiInstanceQueryInstance;
  PFN_WDF_WMI_INSTANCE_SET_INSTANCE   EvtWmiInstanceSetInstance;
  PFN_WDF_WMI_INSTANCE_SET_ITEM       EvtWmiInstanceSetItem;
  PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD EvtWmiInstanceExecuteMethod;
} WDF_WMI_INSTANCE_CONFIG, *PWDF_WMI_INSTANCE_CONFIG;

Member

Size

Die Größe (in Bytes) dieser Struktur.

Provider

Ein Handle für ein WMI-Anbieterobjekt, das ein Treiber durch Aufrufen von WdfWmiProviderCreate abgerufen hat. Wenn dieser Member NULL ist, darf das ProviderConfig-Element nicht NULL sein.

ProviderConfig

Ein Zeiger auf eine WDF_WMI_PROVIDER_CONFIG-Struktur . Wenn dieser Member NULL ist, darf der Provider-Member nicht NULL sein.

UseContextForQuery

Ein boolescher Wert, der bei TRUE angibt, dass der Treiber instance Daten im Kontextbereich des WMI-instance Objekts speichert und keine EvtWmiInstanceQueryInstance-Rückruffunktion bereitstellt. Stattdessen verarbeitet das Framework die Anforderung eines WMI-Clients für instance Daten, indem es den Inhalt des Kontextbereichs an WMI sendet. Wenn dieser Member FALSE ist, muss der Treiber eine EvtWmiInstanceQueryInstance-Rückruffunktion bereitstellen (es sei denn, die instance Daten sind schreibgeschützt).

Wenn UseContextForQueryauf TRUE festgelegt ist, müssen die instance Daten schreibgeschützt sein. Daher kann der Treiber keine EvtWmiInstanceSetInstance- oder EvtWmiInstanceSetItem-Rückruffunktionen bereitstellen.

Register

Ein boolescher Wert, der bei TRUE angibt, dass das Framework den Anbieter instance beim WMI-Dienst des Systems registriert, nachdem es ein WMI-instance-Objekt erstellt hat. Wenn dieser Member FALSE ist, muss der Treiber WdfWmiInstanceRegister aufrufen, um den Anbieter instance zu registrieren.

EvtWmiInstanceQueryInstance

Ein Zeiger auf die EvtWmiInstanceQueryInstance-Rückruffunktion des Treibers für den Anbieter instance oder NULL.

EvtWmiInstanceSetInstance

Ein Zeiger auf die EvtWmiInstanceSetInstance-Rückruffunktion des Treibers für den Anbieter instance oder NULL.

EvtWmiInstanceSetItem

Ein Zeiger auf die EvtWmiInstanceSetItem-Rückruffunktion des Treibers für den Anbieter instance oder NULL.

EvtWmiInstanceExecuteMethod

Ein Zeiger auf die EvtWmiInstanceExecuteMethod-Rückruffunktion des Treibers für den Anbieter instance oder NULL.

Hinweise

Die WDF_WMI_INSTANCE_CONFIG-Struktur wird als Eingabe für die WdfWmiInstanceCreate-Methode verwendet.

Um eine WDF_WMI_INSTANCE_CONFIG-Struktur zu initialisieren, sollte Ihr Treiber WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER oder WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG aufrufen.

Anforderungen

Anforderung	Wert
KMDF-Mindestversion	1.0
Kopfzeile	wdfwmi.h (einschließen von Wdf.h)

Weitere Informationen

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiInstanceSetItem

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceRegister

WdfWmiProviderErstellen