IWDFDevice3::GetHardwareRegisterMappedAddress method

A driver calls GetHardwareRegisterMappedAddress to get the user-mode mapped address of the memory resource it earlier mapped using MapIoSpace.

Syntax

C++


PVOID GetHardwareRegisterMappedAddress(
  [in]  PVOID *PseudoBaseAddress
);

Parameters

PseudoBaseAddress [in]: A pointer to the pseudo base address returned by a previous call to MapIoSpace.

Return value

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

Remarks

After the driver calls GetHardwareRegisterMappedAddress, 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.

For more information, see Reading and Writing to Device Registers in UMDF 1.x Drivers.

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

Requirements