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)