WDF_WMI_INSTANCE_CONFIG 구조체(wdfwmi.h)

아티클
02/29/2024

[KMDF에만 적용]

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

구문

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인 경우 공급자 멤버는 NULL이 아니어야 합니다.

UseContextForQuery

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

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

Register

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

EvtWmiInstanceQueryInstance

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

EvtWmiInstanceSetInstance

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

EvtWmiInstanceSetItem

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

EvtWmiInstanceExecuteMethod

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