WdfDeviceGetHardwareRegisterMappedAddress 関数 (wdfdevice.h)

  • [アーティクル]

[UMDF にのみ適用]

ドライバーは WdfDeviceGetHardwareRegisterMappedAddress を呼び出して、 WdfDeviceMapIoSpace を使用して以前にマップしたメモリ リソースのユーザー モード のマップされたアドレスを取得します。

構文

PVOID WdfDeviceGetHardwareRegisterMappedAddress(
  [in] WDFDEVICE Device,
  [in] PVOID     PseudoBaseAddress
);

パラメーター

[in] Device

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

[in] PseudoBaseAddress

擬似ベース アドレスへのポインターを受け取る場所のアドレス。

戻り値

WdfDeviceMapIoSpace を使用して以前にマップされたリソースのユーザー モードのベース アドレス。

注釈

この関数は、 IWDFDevice3::GetHardwareRegisterMappedAddress に相当する UMDF バージョン 2 です。

ドライバーは WdfDeviceGetHardwareRegisterMappedAddress を呼び出した後、ユーザー モード アドレスに直接アクセスして、レジスタの読み取りと書き込みを行うことができます。

メモ これは、UMDF がアクセスに対して検証を実行できないようにするため、レジスタにアクセスするための推奨される方法ではありません。
 

WdfDeviceGetHardwareRegisterMappedAddress を使用する場合は、UmdfRegisterAccessMode INF ディレクティブを RegisterAccessUsingUserModeMapping に設定する必要があります。 UMDF INF ディレクティブの詳細については、「 INF ファイルでの WDF ディレクティブの指定」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 8.1
対象プラットフォーム ユニバーサル
最小 UMDF バージョン 2.0
Header wdfdevice.h (Wdf.h を含む)
Library WUDFx02000.lib
[DLL] WUDFx02000.dll
IRQL PASSIVE_LEVEL

こちらもご覧ください

IWDFDevice3::GetHardwareRegisterMappedAddress

WdfDeviceMapIoSpace