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

# GetXmaBlockContainingSample

> GetXmaBlockContainingSample

# GetXmaBlockContainingSample

Usa uma tabela de busca especificada para localizar o bloco XBOX Media Audio (XMA) que contém uma amostra decodificada especificada. As entradas da tabela de busca em um arquivo XMA são armazenadas no formato big-endian e às vezes precisam ser convertidas antes que essa função seja chamada.

## Sintaxe

```cpp theme={null}
HRESULT GetXmaBlockContainingSample(  
         DWORD nBlockCount,  
         const DWORD* pSeekTable,  
         DWORD nDesiredSample,  
         DWORD* pnBlockContainingSample,  
         DWORD* pnSampleOffsetWithinBlock  
)  
```

### Parâmetros

*nBlockCount*   \
Tipo: DWORD

Número de blocos no arquivo. Igual ao número de entradas na tabela de busca.

*pSeekTable*   \_In\_count\_(nBlockCount)\
Tipo: DWORD\*

Ponteiro para os dados da tabela de busca.

*nDesiredSample*   \
Tipo: DWORD

Amostra decodificada a ser localizada.

*pnBlockContainingSample*   \_Out\_\
Tipo: DWORD\*

Índice do bloco que contém a amostra.

*pnSampleOffsetWithinBlock*   \_Out\_\
Tipo: DWORD\*

Posição da amostra neste bloco.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Essa função usa o ponteiro `pSeekTable` para localizar o bloco XMA que contém uma determinada amostra decodificada. As entradas da tabela de busca em um arquivo XMA são armazenadas no formato big-endian.

<Note>As entradas da tabela de busca podem precisar ser convertidas antes de chamar essa função.</Note>

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)
- [GetShapeSrcXmaBlocksToSkip](/pt-BR/reference/audio/shapesrccontext/functions/getshapesrcxmablockstoskip.md)
- [SetShapeSrcXmaBlocksToSkip](/pt-BR/reference/audio/shapesrccontext/functions/setshapesrcxmablockstoskip.md)
- [GetXmaSampleRate](/pt-BR/reference/audio/xma2defs/functions/getxmasamplerate.md)
- [SHAPE_XMA_SAMPLE_RATE](/pt-BR/reference/audio/shapexmacontext/enums/shape_xma_sample_rate.md)