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 |
Header | wdfwmi.h (Wdf.h を含む) |
こちらもご覧ください
WDF_WMI_INSTANCE_CONFIG_INIT_PROVIDER