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) |