WdfWmiProviderIsEnabled-Funktion (wdfwmi.h)

[Gilt nur für KMDF]

Die WdfWmiProviderIsEnabled-Methode bestimmt, ob die Datensammlung oder die Ereignisbenachrichtigung für einen angegebenen WMI-Datenanbieter aktiviert ist.

Syntax

BOOLEAN WdfWmiProviderIsEnabled(
  [in] WDFWMIPROVIDER           WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL ProviderControl
);

Parameter

[in] WmiProvider

Ein Handle für ein WMI-Anbieterobjekt, das der Treiber durch Aufrufen von WdfWmiProviderCreate oder WdfWmiInstanceGetProvider abgerufen hat.

[in] ProviderControl

Ein WDF_WMI_PROVIDER_CONTROL typisierter Wert, der einen der Typen von Steuerelementfunktionen (Datensammlung oder Ereignisbenachrichtigung) angibt, die ein WMI-Datenanbieter unterstützen kann.

Rückgabewert

WdfWmiProviderIsEnabled gibt TRUE zurück, wenn die Funktion, die der ProviderControl-Parameter angibt, aktiviert ist und andernfalls FALSE .

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Ein Treiber, der keine EvtWmiProviderFunctionControl-Rückruffunktion bereitstellt, kann WdfWmiProviderIsEnabled aufrufen, um zu bestimmen, ob die Datensammlung oder Ereignisbenachrichtigung aktiviert ist.

Beispiele

Im folgenden Codebeispiel wird ermittelt, ob die Ereignisbenachrichtigung für einen angegebenen WMI-Datenanbieter aktiviert ist.

BOOLEAN eventNotifEnabled;

eventNotifEnabled = WdfWmiProviderIsEnabled(
                                            wmiProvider,
                                            WdfWmiEventControl
                                            );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfwmi.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

EvtWmiProviderFunctionControl

WDF_WMI_PROVIDER_CONTROL

WdfWmiInstanceGetProvider

WdfWmiProviderCreate