> ## 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 實體位址相關聯的虛擬位址。

## 語法

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

### 參數

*apuPhysicalAddress*   \
類型：APU\_ADDRESS

要對應的 APU 實體位址。

### 傳回值

類型：void\*

與指定 APU 實體位址相關聯的虛擬位址。

## 備註

如果實體位址無效，或並非以 [ApuAlloc](/zh-TW/reference/audio/apu/functions/apualloc) 配置，此方法會傳回 nullptr。

`ApuAlloc` 傳回的虛擬位址和實體位址代表相同位址空間的不同檢視。

如果已知虛擬位址，請呼叫 [ApuMapVirtualAddress](/zh-TW/reference/audio/apu/functions/apumapvirtualaddress) 來判斷相關聯的實體位址。

## 需求

**標頭：** apu.h

**程式庫：** acphal.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

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


## Related topics

- [ApuMapApuAddress](/reference/audio/apu/functions/apumapapuaddress.md)
- [ApuMapVirtualAddress](/reference/audio/apu/functions/apumapvirtualaddress.md)