WdfWmiInstanceRegister 関数 (wdfwmi.h)
[KMDF にのみ適用]
WdfWmiInstanceRegister メソッドは、WMI データ プロバイダーの指定されたインスタンスをシステムの WMI サービスに登録します。
構文
NTSTATUS WdfWmiInstanceRegister(
[in] WDFWMIINSTANCE WmiInstance
);
パラメーター
[in] WmiInstance
WdfWmiInstanceCreate の以前の呼び出しからドライバーが取得した WMI インスタンス オブジェクトへのハンドル。
戻り値
操作が成功した場合、WdfWmiInstanceRegister はSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは次のいずれかの値を返す可能性があります。
| リターン コード | 説明 |
|---|---|
|
指定した 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) |