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，則 提供者 成員不得 NULL。

UseContextForQuery

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

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

Register

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

EvtWmiInstanceQueryInstance

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

EvtWmiInstanceSetInstance

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

EvtWmiInstanceSetItem

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

EvtWmiInstanceExecuteMethod

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