WdfDriverGetRegistryPath 関数 (wdfdriver.h)
[KMDF と UMDF に適用]
WdfDriverGetRegistryPath メソッドは、レジストリのサービス ツリー内のドライバーのレジストリ キーへのパスを取得します。
構文
PWSTR WdfDriverGetRegistryPath(
[in] WDFDRIVER Driver
);
パラメーター
[in] Driver
WdfDriverCreate または WdfGetDriver の以前の呼び出しによって取得された、ドライバーのフレームワーク ドライバー オブジェクトへのハンドル。
戻り値
WdfDriverGetRegistryPath は、ドライバーのレジストリ パスを表す NULL で終わる Unicode 文字列へのポインターを返します。 ドライバー ハンドルが無効な場合、システムバグチェックが発生します。
注釈
WdfDriverGetRegistryPath が返すレジストリ パス文字列は、ドライバーが DriverEntry ルーチンへの入力として受け取ったUNICODE_STRING構造体から取得されます。
レジストリの詳細については、「 Framework-Based ドライバーでのレジストリの使用」を参照してください。
例
次のコード例では、レジストリの サービス ツリーでドライバーのレジストリ キーへのパスを取得します。
PWSTR registryPath;
registryPath = WdfDriverGetRegistryPath(driver);
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfdriver.h (Wdf.h を含む) |
| Library | Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |