WDF_WMI_INSTANCE_CONFIG 構造体 (wdfwmi.h)

[アーティクル]
02/29/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

プロバイダーインスタンスのドライバーの EvtWmiInstanceQueryInstance コールバック関数 ( NULL) へのポインター。

EvtWmiInstanceSetInstance

プロバイダーインスタンスのドライバーの EvtWmiInstanceSetInstance コールバック関数へのポインター、または NULL。

EvtWmiInstanceSetItem

プロバイダーインスタンスのドライバーの EvtWmiInstanceSetItem コールバック関数へのポインター、または NULL。

EvtWmiInstanceExecuteMethod

プロバイダーインスタンスのドライバーの EvtWmiInstanceExecuteMethod コールバック関数 ( NULL) へのポインター。