WdfDeviceGetHardwareRegisterMappedAddress function (wdfdevice.h)

[Applies to UMDF only]

A driver calls WdfDeviceGetHardwareRegisterMappedAddress to get the user-mode mapped address of the memory resource it mapped previously using WdfDeviceMapIoSpace.

Syntax

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

Parameters

[in] Device

A handle to a framework device object.

[in] PseudoBaseAddress

The address of a location that receives a pointer to the pseudo base address.

Return value

User-mode base address of the resources mapped earlier using WdfDeviceMapIoSpace.

Remarks

This function is the UMDF version 2 equivalent of IWDFDevice3::GetHardwareRegisterMappedAddress.

After the driver calls WdfDeviceGetHardwareRegisterMappedAddress, it can access the user-mode address directly to read and write to the register.

Note  This is not the recommended approach for accessing registers because it prevents UMDF from doing any validation on the access.
 

If you do use WdfDeviceGetHardwareRegisterMappedAddress, you must set the UmdfRegisterAccessMode INF directive to RegisterAccessUsingUserModeMapping. For more information about UMDF INF directives, see Specifying WDF Directives in INF Files.

Requirements

Requirement Value
Minimum supported client Windows 8.1
Target Platform Universal
Minimum UMDF version 2.0
Header wdfdevice.h (include Wdf.h)
Library WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

See also

IWDFDevice3::GetHardwareRegisterMappedAddress

WdfDeviceMapIoSpace