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

# ApuMapVirtualAddress

傳回與虛擬位址相關聯的 APU 實體位址。

## 語法

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

### 參數

*virtualAddress*   \_In\_\
類型：void\*

要對應的虛擬位址。

### 傳回值

類型：APU\_ADDRESS

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

## 備註

如果虛擬位址無效，或並非以 [ApuAlloc](https://docs.xbox.com/zh-TW/reference/audio/apu/functions/apualloc.md) 配置，此方法會傳回 0。

若要驗證虛擬位址是否有效，請呼叫 [ApuIsVirtualAddressValid](https://docs.xbox.com/zh-TW/reference/audio/apu/functions/apuisvirtualaddressvalid.md)。

如果已知實體位址，請呼叫 [ApuMapApuAddress](https://docs.xbox.com/zh-TW/reference/audio/apu/functions/apumapapuaddress.md) 來判斷相關聯的虛擬位址。

## 需求

**標頭：** apu.h

**程式庫：** acphal.lib

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

## 另請參閱

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


## Related topics

- [ApuMapApuAddress](https://docs.xbox.com/zh-TW/reference/audio/apu/functions/apumapapuaddress.md)
- [ApuIsVirtualAddressValid](https://docs.xbox.com/zh-TW/reference/audio/apu/functions/apuisvirtualaddressvalid.md)
- [APU (音訊處理單元)](https://docs.xbox.com/zh-TW/reference/audio/apu/apu_members.md)
- [ApuFree](https://docs.xbox.com/zh-TW/reference/audio/apu/functions/apufree.md)
- [ApuAlloc](https://docs.xbox.com/zh-TW/reference/audio/apu/functions/apualloc.md)