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
WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER