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.