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 |