WdfWmiProviderIsEnabled 函数 (wdfwmi.h)
[仅适用于 KMDF]
WdfWmiProviderIsEnabled 方法确定是否为指定的 WMI 数据提供程序启用了数据收集或事件通知。
语法
BOOLEAN WdfWmiProviderIsEnabled(
[in] WDFWMIPROVIDER WmiProvider,
[in] WDF_WMI_PROVIDER_CONTROL ProviderControl
);
参数
[in] WmiProvider
驱动程序通过调用 WdfWmiProviderCreate 或 WdfWmiInstanceGetProvider 获取的 WMI 提供程序对象的句柄。
[in] ProviderControl
一个WDF_WMI_PROVIDER_CONTROL类型的值,该值指定 WMI 数据提供程序可以支持的 (数据收集或事件通知) 控件函数类型之一。
返回值
如果 ProviderControl 参数指定的功能已启用,则 WdfWmiProviderIsEnabled 返回 TRUE,否则返回 FALSE。
如果驱动程序提供无效的对象句柄,则会发生 bug 检查。
注解
不提供 EvtWmiProviderFunctionControl 回调函数的驱动程序可以调用 WdfWmiProviderIsEnabled 来确定是否启用了数据收集或事件通知。
示例
下面的代码示例确定是否为指定的 WMI 数据提供程序启用了事件通知。
BOOLEAN eventNotifEnabled;
eventNotifEnabled = WdfWmiProviderIsEnabled(
wmiProvider,
WdfWmiEventControl
);
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.0 |
标头 | wdfwmi.h (包括 Wdf.h) |
Library | Wdf01000.sys (请参阅框架库版本控制.) |
IRQL | <=DISPATCH_LEVEL |
DDI 符合性规则 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |