次の方法で共有

WdfDeviceOpenRegistryKey 関数 (wdfdevice.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfDeviceOpenRegistryKey メソッドは、デバイスのハードウェア キーまたはドライバーのソフトウェア キーをレジストリで開き、レジストリ キーを表すフレームワーク レジストリ キー オブジェクトを作成します。

構文

NTSTATUS WdfDeviceOpenRegistryKey(
  [in]           WDFDEVICE              Device,
  [in]           ULONG                  DeviceInstanceKeyType,
  [in]           ACCESS_MASK            DesiredAccess,
  [in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
  [out]          WDFKEY                 *Key
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] DeviceInstanceKeyType

開くキーまたはサブキーを指定します。

手記

UMDF では、サブキーの作成はサポートされていません。

これは、次のフラグのビットごとの OR です (Wdm.hで定義されています)。

DeviceInstanceKeyType フラグ 意味 フレームワーク
PLUGPLAY_REGKEY_DEVICE デバイスのハードウェア キーを開きます。 KMDF/UMDF
PLUGPLAY_REGKEY_DRIVER ドライバーのソフトウェア キーを開きます。 このフラグを設定する UMDF ドライバーも DesiredAccess を KEY_READに設定する必要があります。 それ以外の場合、このメソッドは STATUS_ACCESS_DENIEDを返します。 KMDF/UMDF
PLUGPLAY_REGKEY_CURRENT_HWPROFILE KMDF ドライバーは、このフラグを使用して、現在のハードウェア プロファイルにあるハードウェアまたはソフトウェア キーのコピーを開きます。 KMDF
PLUGPLAY_REGKEY_DRIVER |WDF_REGKEY_DRIVER_SUBKEY UMDF ドライバーでは、これらのフラグを使用して、読み取り/書き込みアクセス用にドライバーのソフトウェア キーの ServiceName サブキーを開きます。 UMDF
PLUGPLAY_REGKEY_DEVICE |WDF_REGKEY_DEVICE_SUBKEY 同様に、UMDF ドライバーはこれらのフラグを使用して、読み取り/書き込みアクセス用にデバイスのハードウェア キーの ServiceName サブキーを開きます。 UMDF

[in] DesiredAccess

ドライバーが指定したレジストリ キーに対して要求しているアクセス権を指定する ACCESS_MASK型指定された値。

KMDF ドライバーは、通常、KEY_READ、KEY_WRITE、または KEY_READ を要求します。 |KEY_WRITE.

UMDF ドライバーを作成する場合は、次の表を使用します。

DeviceInstanceKeyType DesiredAccess
PLUGPLAY_REGKEY_DEVICE KEY_READ
PLUGPLAY_REGKEY_DEVICE |WDF_REGKEY_DEVICE_SUBKEY KEY_READ または KEY_READ |KEY_SET_VALUE
PLUGPLAY_REGKEY_DRIVER KEY_READ
PLUGPLAY_REGKEY_DRIVER |WDF_REGKEY_DRIVER_SUBKEY KEY_READ または KEY_READ |KEY_SET_VALUE
 

ベスト プラクティスとして、ドライバーに必要なアクセスの種類のみを要求します。

[in, optional] KeyAttributes

新しいレジストリ キー オブジェクトのドライバー指定の属性を含む WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。

[out] Key

新しいレジストリ キー オブジェクトへのハンドルを受け取る場所へのポインター。

戻り値

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

リターン コード 形容
STATUS_INVALID_DEVICE_REQUEST

IRQL = PASSIVE_LEVEL で WdfDeviceOpenRegistryKey が呼び出されませんでした。
STATUS_INVALID_PARAMETER
 無効なパラメーターが指定されました。 UMDF の場合、この戻り値はアクセス権が不十分であることを示す可能性があります。
STATUS_INSUFFICIENT_RESOURCES
 レジストリ キー オブジェクトを割り当てませんでした。
STATUS_OBJECT_NAME_NOT_FOUND
 指定されたレジストリ キーが存在しません。
 

WdfDeviceOpenRegistryKey メソッドが返す可能性があるその他の戻り値の一覧については、「Framework オブジェクト作成エラー」を参照してください。

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

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

備考

ドライバーが WdfDeviceCreate を呼び出す前にハードウェアまたはソフトウェア キー開く必要がある場合は、WdfDeviceOpenRegistryKey ではなく、WdfFdoInitOpenRegistryKey呼び出す必要があります。

WdfDeviceOpenRegistryKeyで開いたレジストリ キーの使用が完了したら、ドライバーは WdfRegistryClose 呼び出す必要があります。

レジストリ、ハードウェアおよびソフトウェア キー、およびレジストリ オブジェクトの詳細については、「Framework-Based ドライバー でのレジストリの使用」を参照してください。

例

WdfDeviceOpenRegistryKey 使用するコード例については、「WdfRegistryCreateKey 、WdfRegistryOpenKey、および WdfRegistryQueryValue を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
最小 KMDF バージョン 1.0
UMDF の最小バージョン を する 2.0
ヘッダー wdfdevice.h (Wdf.h を含む)
ライブラリ Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 を する AccessHardwareKey(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

関連項目

WdfFdoInitOpenRegistryKey