> ## 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.

# ApuMapVirtualAddress

> ApuMapVirtualAddress

# ApuMapVirtualAddress

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

## Syntax

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

### Parameters

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

要映射的虚拟地址。

### Return value

Type: APU\_ADDRESS

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

## Remarks

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

若要验证虚拟地址是否有效,请调用 [ApuIsVirtualAddressValid](/reference/audio/apu/functions/apuisvirtualaddressvalid)。

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

## Requirements

**头文件:** apu.h

**库:** acphal.lib

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

## See also

[ApuIsVirtualAddressValid](/reference/audio/apu/functions/apuisvirtualaddressvalid)\
[ApuMapApuAddress](/reference/audio/apu/functions/apumapapuaddress)\
[APU](/reference/audio/apu/apu_members)


## Related topics

- [ApuMapApuAddress](/zh-CN/reference/audio/apu/functions/apumapapuaddress.md)
- [ApuIsVirtualAddressValid](/zh-CN/reference/audio/apu/functions/apuisvirtualaddressvalid.md)
- [APU(音频处理单元)](/zh-CN/reference/audio/apu/apu_members.md)
- [ApuFree](/zh-CN/reference/audio/apu/functions/apufree.md)
- [ApuAlloc](/zh-CN/reference/audio/apu/functions/apualloc.md)