WDF_WMI_INSTANCE_CONFIG結構 (wdfwmi.h)

發行項
02/27/2024

[僅適用於 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， 提供者 成員不得為 NULL。

UseContextForQuery

布爾值，如果 為 TRUE，表示驅動程式會將實例數據儲存在 WMI 實例對象的內容空間中，而且不會提供 EvtWmiInstanceQueryInstance 回呼函式。相反地，架構會藉由將內容空間的內容傳送至 WMI，以服務 WMI 用戶端的實例數據要求。如果此成員為 FALSE，驅動程式必須提供 EvtWmiInstanceQueryInstance 回呼函式 (，除非實例數據是只讀的) 。

如果 UseContextForQuery 為 TRUE，則實例數據必須是只讀的，因此驅動程式無法提供 EvtWmiInstanceSetInstance 或 EvtWmiInstanceSetItem 回呼函式。

Register

布爾值，如果為 TRUE，表示架構會在建立 WMI 實例對象之後，向系統的 WMI 服務註冊提供者實例。如果此成員為 FALSE，驅動程式必須呼叫 WdfWmiInstanceRegister 來註冊提供者實例。

EvtWmiInstanceQueryInstance

提供者實例或 NULL 之驅動程式 EvtWmiInstanceQueryInstance 回呼函式的指標。

EvtWmiInstanceSetInstance

提供者實例的驅動程式 EvtWmiInstanceSetInstance 回呼函式的指標，或 NULL。

EvtWmiInstanceSetItem

驅動程式的 EvtWmiInstanceSetItem 回呼函式指標，用於提供者實例或 NULL。

EvtWmiInstanceExecuteMethod

驅動程式 EvtWmiInstanceExecuteMethod 回呼函式的指標，用於提供者實例或 NULL。