WdfWmiProviderIsEnabled 함수(wdfwmi.h)

[KMDF에만 적용]

WdfWmiProviderIsEnabled 메서드는 지정된 WMI 데이터 공급자에 대해 데이터 수집 또는 이벤트 알림을 사용할 수 있는지 여부를 결정합니다.

구문

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

매개 변수

[in] WmiProvider

WdfWmiProviderCreate 또는 WdfWmiInstanceGetProvider를 호출하여 드라이버가 가져온 WMI 공급자 개체에 대한 핸들입니다.

[in] ProviderControl

WMI 데이터 공급자가 지원할 수 있는 제어 함수 유형(데이터 수집 또는 이벤트 알림) 중 하나를 지정하는 WDF_WMI_PROVIDER_CONTROL 형식의 값입니다.

반환 값

ProviderControl 매개 변수가 지정하는 기능이 사용하도록 설정되어 있으면 WdfWmiProviderIsEnabled가 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

EvtWmiProviderFunctionControl 콜백 함수를 제공하지 않는 드라이버는 WdfWmiProviderIsEnabled를 호출하여 데이터 수집 또는 이벤트 알림이 사용되는지 여부를 확인할 수 있습니다.

예제

다음 코드 예제에서는 지정된 WMI 데이터 공급자에 대해 이벤트 알림을 사용할 수 있는지 여부를 결정합니다.

BOOLEAN eventNotifEnabled;

eventNotifEnabled = WdfWmiProviderIsEnabled(
                                            wmiProvider,
                                            WdfWmiEventControl
                                            );

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
머리글	wdfwmi.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL	<=DISPATCH_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

EvtWmiProviderFunctionControl

WDF_WMI_PROVIDER_CONTROL

WdfWmiInstanceGetProvider

WdfWmiProviderCreate