> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ApuMapVirtualAddress

> ApuMapVirtualAddress

Returns the APU physical address that is associated with a virtual address.

## Syntax

```cpp theme={null}
APU_ADDRESS ApuMapVirtualAddress(  
         const void* virtualAddress  
)  
```

### Parameters

*virtualAddress*   \_In\_\
Type: void\*

Virtual address to map.

### Return value

Type: APU\_ADDRESS

APU physical address associated with the specified virtual address.

## Remarks

This method returns 0 if the virtual address is invalid or if it was not allocated with [ApuAlloc](https://docs.xbox.com/reference/audio/apu/functions/apualloc.md).

To verify whether a virtual address is valid, call [ApuIsVirtualAddressValid](https://docs.xbox.com/reference/audio/apu/functions/apuisvirtualaddressvalid.md).

If the physical address is known, call [ApuMapApuAddress](https://docs.xbox.com/reference/audio/apu/functions/apumapapuaddress.md) to determine the associated virtual address.

## Requirements

**Header:** apu.h

**Library:** acphal.lib

**Supported platforms:** XBOX One family consoles and XBOX Series consoles

## See also

[ApuIsVirtualAddressValid](https://docs.xbox.com/reference/audio/apu/functions/apuisvirtualaddressvalid.md)\
[ApuMapApuAddress](https://docs.xbox.com/reference/audio/apu/functions/apumapapuaddress.md)\
[APU](https://docs.xbox.com/reference/audio/apu/apu_members.md)


## Related topics

- [ApuMapApuAddress](https://docs.xbox.com/reference/audio/apu/functions/apumapapuaddress.md)
- [ApuIsVirtualAddressValid](https://docs.xbox.com/reference/audio/apu/functions/apuisvirtualaddressvalid.md)
- [APU (Audio Processing Unit)](https://docs.xbox.com/reference/audio/apu/apu_members.md)
- [Map](https://docs.xbox.com/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [ApuFree](https://docs.xbox.com/reference/audio/apu/functions/apufree.md)