共用方式為


WDF_WMI_INSTANCE_CONFIG結構 (wdfwmi.h)

[僅適用於 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 回呼函式 (,除非實例數據是只讀的) 。

如果 UseContextForQueryTRUE,則實例數據必須是只讀的,因此驅動程式無法提供 EvtWmiInstanceSetInstanceEvtWmiInstanceSetItem 回 呼函式。

Register

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

EvtWmiInstanceQueryInstance

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

EvtWmiInstanceSetInstance

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

EvtWmiInstanceSetItem

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

EvtWmiInstanceExecuteMethod

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

備註

WDF_WMI_INSTANCE_CONFIG 結構會當做 WdfWmiInstanceCreate 方法的輸入使用。

若要初始化 WDF_WMI_INSTANCE_CONFIG 結構,您的驅動程式應該呼叫 WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDERWDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG

規格需求

需求
最低 KMDF 版本 1.0
標頭 wdfwmi.h (包含 Wdf.h)

另請參閱

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiInstanceSetItem

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER

WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER_CONFIG

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceRegister

WdfWmiProviderCreate