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

# ApuMapApuAddress

> ApuMapApuAddress

# ApuMapApuAddress

返回与 APU 物理地址关联的虚拟地址。

## Syntax

```cpp theme={null}
void* ApuMapApuAddress(  
         APU_ADDRESS apuPhysicalAddress  
)  
```

### Parameters

*apuPhysicalAddress*   \
Type: APU\_ADDRESS

要映射的 APU 物理地址。

### Return value

Type: void\*

与指定的 APU 物理地址关联的虚拟地址。

## Remarks

如果物理地址无效或未通过 [ApuAlloc](/reference/audio/apu/functions/apualloc) 分配,则此方法返回 nullptr。

`ApuAlloc` 返回的虚拟地址和物理地址表示同一地址空间的不同视图。

如果已知虚拟地址,请调用 [ApuMapVirtualAddress](/reference/audio/apu/functions/apumapvirtualaddress) 来确定关联的物理地址。

## Requirements

**头文件:** apu.h

**库:** acphal.lib

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## See also

[ApuMapVirtualAddress](/reference/audio/apu/functions/apumapvirtualaddress)\
[APU](/reference/audio/apu/apu_members)


## Related topics

- [ApuMapVirtualAddress](/zh-CN/reference/audio/apu/functions/apumapvirtualaddress.md)
- [ApuIsVirtualAddressValid](/zh-CN/reference/audio/apu/functions/apuisvirtualaddressvalid.md)
- [APU(音频处理单元)](/zh-CN/reference/audio/apu/apu_members.md)
- [SetShapeXmaInputBuffer0(SHAPE_XMA_CONTEXT*, APU_ADDRESS)](/zh-CN/reference/audio/shapexmacontext/functions/setshapexmainputbuffer0_2.md)
- [SetShapeXmaInputBuffer1(SHAPE_XMA_CONTEXT*, APU_ADDRESS)](/zh-CN/reference/audio/shapexmacontext/functions/setshapexmainputbuffer1_2.md)