Fungsi WdfDeviceGetHardwareRegisterMappedAddress (wdfdevice.h)

[Hanya berlaku untuk UMDF]

Driver memanggil WdfDeviceGetHardwareRegisterMappedAddress untuk mendapatkan alamat yang dipetakan mode pengguna dari sumber daya memori yang dipetakan sebelumnya menggunakan WdfDeviceMapIoSpace.

Sintaks

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

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] PseudoBaseAddress

Alamat lokasi yang menerima penunjuk ke alamat dasar pseudo.

Nilai kembali

Alamat dasar mode pengguna dari sumber daya yang dipetakan sebelumnya menggunakan WdfDeviceMapIoSpace.

Keterangan

Fungsi ini adalah UMDF versi 2 yang setara dengan IWDFDevice3::GetHardwareRegisterMappedAddress.

Setelah driver memanggil WdfDeviceGetHardwareRegisterMappedAddress, driver dapat mengakses alamat mode pengguna secara langsung untuk membaca dan menulis ke register.

Catatan Ini bukan pendekatan yang direkomendasikan untuk mengakses register karena mencegah UMDF melakukan validasi pada akses.

 

Jika Anda menggunakan WdfDeviceGetHardwareRegisterMappedAddress, Anda harus mengatur arahan INF UmdfRegisterAccessMode ke RegisterAccessUsingUserModeMapping. Untuk informasi selengkapnya tentang arahan UMDF INF, lihat Menentukan Arahan WDF dalam File INF.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1
Target Platform	Universal
Versi UMDF minimum	2.0
Header	wdfdevice.h (termasuk Wdf.h)
Pustaka	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Lihat juga

IWDFDevice3::GetHardwareRegisterMappedAddress

WdfDeviceMapIoSpace