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

Retorna o endereço físico da APU associado a um endereço virtual.

## Sintaxe

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

### Parâmetros

*virtualAddress*   \_In\_\
Tipo: void\*

Endereço virtual a ser mapeado.

### Valor de retorno

Tipo: APU\_ADDRESS

Endereço físico da APU associado ao endereço virtual especificado.

## Comentários

Este método retorna 0 se o endereço virtual for inválido ou se ele não tiver sido alocado com [ApuAlloc](https://docs.xbox.com/pt-BR/reference/audio/apu/functions/apualloc.md).

Para verificar se um endereço virtual é válido, chame [ApuIsVirtualAddressValid](https://docs.xbox.com/pt-BR/reference/audio/apu/functions/apuisvirtualaddressvalid.md).

Se o endereço físico for conhecido, chame [ApuMapApuAddress](https://docs.xbox.com/pt-BR/reference/audio/apu/functions/apumapapuaddress.md) para determinar o endereço virtual associado.

## Requisitos

**Cabeçalho:** apu.h

**Biblioteca:** acphal.lib

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

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


## Related topics

- [ApuMapApuAddress](https://docs.xbox.com/pt-BR/reference/audio/apu/functions/apumapapuaddress.md)
- [ApuIsVirtualAddressValid](https://docs.xbox.com/pt-BR/reference/audio/apu/functions/apuisvirtualaddressvalid.md)
- [APU (Unidade de Processamento de Áudio)](https://docs.xbox.com/pt-BR/reference/audio/apu/apu_members.md)
- [ApuAlloc](https://docs.xbox.com/pt-BR/reference/audio/apu/functions/apualloc.md)
- [ApuFree](https://docs.xbox.com/pt-BR/reference/audio/apu/functions/apufree.md)