> ## 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 una tabla de búsqueda especificada para encontrar el bloque de XBOX Media Audio (XMA) que contiene una muestra descodificada especificada. Las entradas de la tabla de búsqueda de un archivo XMA se almacenan en formato big-endian y, en ocasiones, deben convertirse antes de llamar a esta función.

## Sintaxis

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

### Parámetros

*nBlockCount*   \
Tipo: DWORD

Número de bloques del archivo. Es el mismo que el número de entradas de la tabla de búsqueda.

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

Puntero a los datos de la tabla de búsqueda.

*nDesiredSample*   \
Tipo: DWORD

Muestra descodificada que se va a localizar.

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

Índice del bloque que contiene la muestra.

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

Posición de la muestra en este bloque.

### Valor devuelto

Tipo: HRESULT

Código de ejecución correcta `S_OK` o de error `E_FAIL`.

## Comentarios

Esta función usa el puntero `pSeekTable` para encontrar el bloque de XMA que contiene una muestra descodificada determinada. Las entradas de la tabla de búsqueda de un archivo XMA se almacenan en formato big-endian.

<Note>Es posible que las entradas de la tabla de búsqueda deban convertirse antes de llamar a esta función.</Note>

Para obtener más información sobre XMA2, consulte [Información general de XMA2](/build/console-features/audio/overviews/xma2-overview). Para obtener información general de la arquitectura de audio de XBOX One, consulte **El sonido del futuro**: [La arquitectura de audio en XBOX One](/build/console-features/audio/overviews/xbox-one-audio-architecture).

## Requisitos

**Encabezado:** xma2defs.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[xma2defs](/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [XMA2Defs](/es/reference/audio/xma2defs/xma2defs_members.md)
- [GetXmaSampleRate](/es/reference/audio/xma2defs/functions/getxmasamplerate.md)
- [SHAPE_XMA_SAMPLE_RATE](/es/reference/audio/shapexmacontext/enums/shape_xma_sample_rate.md)
- [GetShapeXmaSampleRate](/es/reference/audio/shapexmacontext/functions/getshapexmasamplerate.md)
- [GetXmaDecodePositionForSample](/es/reference/audio/xma2defs/functions/getxmadecodepositionforsample.md)