EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL 콜백 함수(wdfwmi.h)

아티클
02/29/2024

[KMDF에만 적용]

드라이버의 EvtWmiProviderFunctionControl 콜백 함수는 지정된 WMI 데이터 공급자에 대한 데이터 수집 및 이벤트 전송에 대한 드라이버 지원을 사용하거나 사용하지 않도록 설정합니다.

구문

EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;

NTSTATUS EvtWdfWmiProviderFunctionControl(
  [in] WDFWMIPROVIDER WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL Control,
  [in] BOOLEAN Enable
)
{...}

매개 변수

[in] WmiProvider

WMI 공급자 개체에 대한 핸들입니다.

[in] Control

드라이버에서 사용하거나 사용하지 않도록 설정해야 하는 기능을 식별하는 WDF_WMI_PROVIDER_CONTROL 형식의 값입니다.

[in] Enable

TRUE이면 드라이버가 Control에서 지정하는 기능을 사용하도록 설정해야 했음을 나타내는 부울 값입니다. FALSE이면 드라이버가 기능을 사용하지 않도록 설정해야 합니다.

반환 값

작업이 성공하면 EvtWmiProviderFunctionControl 콜백 함수가 STATUS_SUCCESS 반환해야 합니다. 그렇지 않으면 NT_SUCCESS(상태)이 FALSE와 같은 상태 값을 반환해야 합니다.

설명

EvtWmiProviderFunctionControl 콜백 함수를 등록하려면 드라이버가 WdfWmiProviderCreate를 호출하기 전에 함수의 주소를 WDF_WMI_PROVIDER_CONFIG 구조에 배치해야 합니다.

드라이버가 WMI 데이터 공급자의 WDF_WMI_PROVIDER_CONFIG 구조의 Flags 멤버에서 WdfWmiProviderExpensive 플래그를 설정하고 드라이버가 EvtWmiProviderFunctionControl 콜백 함수를 제공하는 경우 프레임워크는 드라이버가 WMI 데이터 수집 기능을 사용하거나 사용하지 않도록 설정해야 할 때 콜백 함수를 호출합니다.

드라이버는 EvtWmiProviderFunctionControl 콜백 함수를 제공하는 대신 WdfWmiProviderIsEnabled를 호출하여 데이터 수집을 사용하거나 사용하지 않도록 설정해야 하는지 확인할 수 있습니다.

EvtWmiProviderFunctionControl 콜백 함수에 대한 자세한 내용은 Framework-Based 드라이버에서 WMI 지원을 참조하세요.