EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL 콜백 함수(wdfwmi.h)

아티클
02/07/2025

[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를 참조하세요.