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

# GetXmaDecodePositionForSample

> GetXmaDecodePositionForSample

# GetXmaDecodePositionForSample

Obtém os dados necessários para fazer com que o decodificador gere áudio a partir de uma posição de amostra especificada em relação ao início do bloco XBOX Media Audio (XMA) especificado.

## Sintaxe

```cpp theme={null}
HRESULT GetXmaDecodePositionForSample(  
         const BYTE* pXmaData,  
         DWORD nXmaDataBytes,  
         DWORD nStreamIndex,  
         DWORD nDesiredSample,  
         DWORD* pnBitOffset,  
         DWORD* pnSubFrame  
)  
```

### Parâmetros

*pXmaData*   \_In\_bytecount\_(nXmaDataBytes)\
Tipo: BYTE\*

Ponteiro para blocos XMA.

*nXmaDataBytes*   \
Tipo: DWORD

Tamanho de pXmaData, em bytes.

*nStreamIndex*   \
Tipo: DWORD

Fluxo no qual buscar.

*nDesiredSample*   \
Tipo: DWORD

Amostra buscada.

*pnBitOffset*   \_Out\_\
Tipo: DWORD\*

Retorna o deslocamento de bits, dentro de pXmaData, do quadro que contém a amostra buscada.

*pnSubFrame*   \_Out\_\
Tipo: DWORD\*

Retorna o subquadro que contém a amostra.

### Valor retornado

Tipo: HRESULT

Código de êxito `S_OK` ou de erro `E_FAIL`.

## Comentários

Essa função obtém os dados necessários para fazer com que o decodificador gere áudio a partir de uma determinada posição de amostra em relação ao início do bloco XMA especificado. Isso inclui o deslocamento de bits do quadro apropriado e o subquadro correto dentro desse quadro. Os dados podem ser passados diretamente para a função `XMAPlaybackSetDecodePosition`. Para obter mais informações sobre o XMA2, consulte [Visão geral do XMA2](/pt-BR/build/console-features/audio/overviews/xma2-overview). Para obter uma visão geral da arquitetura de áudio do XBOX One, consulte **O som do futuro**: [A arquitetura de áudio no XBOX One](/pt-BR/build/console-features/audio/overviews/xbox-one-audio-architecture).

## Requisitos

**Cabeçalho:** xma2defs.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[xma2defs](/pt-BR/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [XMA2Defs](/pt-BR/reference/audio/xma2defs/xma2defs_members.md)
- [GetXmaFrameBitPosition](/pt-BR/reference/audio/xma2defs/functions/getxmaframebitposition.md)
- [GetLastXmaFrameBitPosition](/pt-BR/reference/audio/xma2defs/functions/getlastxmaframebitposition.md)
- [GetShapeXmaNumSubframesToDecode](/pt-BR/reference/audio/shapexmacontext/functions/getshapexmanumsubframestodecode.md)
- [SetSamplePositions](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_setsamplepositions_public.md)