SoundMapPortAddress

PUCHAR
   SoundMapPortAddress(
       INTERFACE_TYPE
BusType,
       ULONG
BusNumber,
       ULONG
PortBase,
       ULONG
Length,
       PULONG
MemType
       );

The SoundMapPortAddress function translates a bus-specific address into the corresponding system-logical address and then, if the logical address is in memory address space, maps the address to a virtual address.

Parameters

BusType

Bus type. INTERFACE_TYPE is defined in ntddk.h.

BusNumber

Bus number, as returned from SoundGetBusNumber.

PortBase

Port number.

Length

Number of ports.

MemType

Address of a location to receive a value indicating the memory type. A value of zero indicates the return value is a memory address. A value of one indicates the return value is an I/O space address.

Return Value

Returns the base virtual address.

Comments

Use SoundMapPortAddress to obtain addresses that are suitable for use with HAL Port I/O routines, such as READ_PORT_UCHAR.

If a value of zero is received in the address pointed to by memtype, then the returned virtual address is a mapped address. In this case the driver must call MmUnmapIoSpace to unmap the address range, prior to being unloaded.

This function calls HalTranslateBusAddress and MmMapIoSpace.


Send feedback to MSDN.Look here for MSDN Online resources.