WdfWmiInstanceRegister 関数 (wdfwmi.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfWmiInstanceRegister メソッドは、WMI データ プロバイダーの指定されたインスタンスをシステムの WMI サービスに登録します。

構文

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

パラメーター

[in] WmiInstance

WdfWmiInstanceCreate の以前の呼び出しからドライバーが取得した WMI インスタンス オブジェクトへのハンドル。

戻り値

操作が成功した場合、WdfWmiInstanceRegister はSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは次のいずれかの値を返す可能性があります。

リターン コード 説明
STATUS_INVALID_DEVICE_REQUEST
 指定した WMI インスタンスが既に登録されています。
 

このメソッドは、他の NTSTATUS 値を返す場合もあります。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

プロバイダー インスタンスは、登録されるまで WMI クライアントで使用できません。 ドライバーは、WdfWmiInstanceRegister を呼び出すか、インスタンスのWDF_WMI_INSTANCE_CONFIG構造体の Register メンバーを TRUE に設定する必要があります。

WdfWmiInstanceRegister メソッドの詳細については、「プロバイダー インスタンスの登録」を参照してください。 WMI の詳細については、「 Framework-Based ドライバーでの WMI のサポート」を参照してください。

WdfWmiInstanceRegister は、IRQL = PASSIVE_LEVEL で呼び出された場合は (つまり、返される前に) プロバイダー インスタンスを同期的に登録し、IRQL > PASSIVE_LEVELで呼び出された場合は非同期的に登録します。

例

次のコード例では、WMI データ プロバイダーの指定されたインスタンスをシステムの WMI サービスに登録します。

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
Header wdfwmi.h (Wdf.h を含む)
Library Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister