次の方法で共有


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 コールバック関数を提供する必要があります (インスタンス データが書き込み専用でない場合)。

UseContextForQuery が TRUE 場合、インスタンス データは読み取り専用である必要があるため、ドライバーは EvtWmiInstanceSetInstance または EvtWmiInstanceSetItem コールバック関数 提供できません。

Register

TRUE 場合、フレームワークが WMI インスタンス オブジェクトを作成した後、システムの WMI サービスにプロバイダー インスタンスを登録することを示すブール値。 このメンバーが FALSE 場合、ドライバーは WdfWmiInstanceRegister を呼び出してプロバイダー インスタンスを登録する必要があります。

EvtWmiInstanceQueryInstance

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

EvtWmiInstanceSetInstance

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

EvtWmiInstanceSetItem

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

EvtWmiInstanceExecuteMethod

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

備考

WDF_WMI_INSTANCE_CONFIG 構造体は、WdfWmiInstanceCreate メソッドへの入力として使用されます。

WDF_WMI_INSTANCE_CONFIG 構造体を初期化するには、ドライバーが WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER または WDF_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