WdfWmiProviderIsEnabled-Funktion (wdfwmi.h)
[Gilt nur für KMDF]
Die WdfWmiProviderIsEnabled--Methode bestimmt, ob eine Datensammlung oder 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.
[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.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Ein Treiber, der keine EvtWmiProviderFunctionControl Rückruffunktion bereitstellt, kann WdfWmiProviderIsEnabled- aufrufen, um festzustellen, 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- | Universal |
| Minimale KMDF-Version | 1.0 |
| Header- | wdfwmi.h (einschließen Wdf.h) |
| Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |