WDF_WMI_INSTANCE_CONFIG 구조체(wdfwmi.h)

아티클
02/07/2025

[KMDF에만 적용]

WDF_WMI_INSTANCE_CONFIG 구조에는 WMI 데이터 공급자 인스턴스에 대한 구성 정보가 포함됩니다.

통사론

typedef struct _WDF_WMI_INSTANCE_CONFIG {
  ULONG                               Size;
  WDFWMIPROVIDER                      Provider;
  PWDF_WMI_PROVIDER_CONFIG            ProviderConfig;
  BOOLEAN                             UseContextForQuery;
  BOOLEAN                             Register;
  PFN_WDF_WMI_INSTANCE_QUERY_INSTANCE EvtWmiInstanceQueryInstance;
  PFN_WDF_WMI_INSTANCE_SET_INSTANCE   EvtWmiInstanceSetInstance;
  PFN_WDF_WMI_INSTANCE_SET_ITEM       EvtWmiInstanceSetItem;
  PFN_WDF_WMI_INSTANCE_EXECUTE_METHOD EvtWmiInstanceExecuteMethod;
} WDF_WMI_INSTANCE_CONFIG, *PWDF_WMI_INSTANCE_CONFIG;

회원

Size

이 구조체의 크기(바이트)입니다.

Provider

WdfWmiProviderCreate를 호출하여 드라이버가 가져온 WMI 공급자 개체에 대한 핸들이. 이 멤버가 NULL 경우 ProviderConfig 멤버는 NULL 않아야 합니다.

ProviderConfig

WDF_WMI_PROVIDER_CONFIG 구조체에 대한 포인터입니다. 이 멤버가 NULL 경우 Provider 멤버는 NULL 않아야 합니다.

UseContextForQuery

TRUE 경우 드라이버가 WMI 인스턴스 개체의 컨텍스트 공간에 인스턴스 데이터를 저장하고 EvtWmiInstanceQueryInstance 콜백 함수를 제공하지 않음을 나타내는 부울 값입니다. 대신 프레임워크는 컨텍스트 공간의 콘텐츠를 WMI로 전송하여 인스턴스 데이터에 대한 WMI 클라이언트의 요청을 서비스합니다. 이 멤버가 FALSE 경우 드라이버는 EvtWmiInstanceQueryInstance 콜백 함수를 제공해야 합니다(인스턴스 데이터가 쓰기 전용이 아닌 경우).

UseContextForQuery 경우 인스턴스 데이터는 읽기 전용이어야 하므로 드라이버는 EvtWmiInstanceSetInstance 또는 EvtWmiInstanceSetItem 콜백 함수를 제공할 수 없습니다.

Register

TRUE 경우 프레임워크가 WMI 인스턴스 개체를 만든 후 시스템의 WMI 서비스에 공급자 인스턴스를 등록한다는 것을 나타내는 부울 값입니다. 이 멤버가 FALSE 경우 드라이버는 WdfWmiInstanceRegister 호출하여 공급자 인스턴스를 등록해야 합니다.

EvtWmiInstanceQueryInstance

공급자 인스턴스에 대한 드라이버의 EvtWmiInstanceQueryInstance 콜백 함수에 대한 포인터이거나 NULL .

EvtWmiInstanceSetInstance

공급자 인스턴스에 대한 드라이버의 EvtWmiInstanceSetInstance 콜백 함수 또는 NULL 대한 포인터입니다.

EvtWmiInstanceSetItem

공급자 인스턴스에 대한 드라이버의 EvtWmiInstanceSetItem 콜백 함수에 대한 포인터이거나 NULL .

EvtWmiInstanceExecuteMethod

공급자 인스턴스에 대한 드라이버의 EvtWmiInstanceExecuteMethod 콜백 함수에 대한 포인터이거나 NULL .