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

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

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

[in] DesiredAccess

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

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

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

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

[in, optional] KeyAttributes

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

[out] Key

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

戻り値

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

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

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

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

注釈

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

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

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

例

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

要件

こちらもご覧ください

WdfFdoInitOpenRegistryKey