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

Obtiene los datos necesarios para hacer que el descodificador genere audio a partir de una posición de muestra especificada relativa al principio del bloque de XBOX Media Audio (XMA) especificado.

## Sintaxis

```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\*

Puntero a bloques de XMA.

*nXmaDataBytes*   \
Tipo: DWORD

Tamaño de pXmaData, en bytes.

*nStreamIndex*   \
Tipo: DWORD

Secuencia dentro de la cual buscar.

*nDesiredSample*   \
Tipo: DWORD

Muestra buscada.

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

Devuelve el desplazamiento de bits dentro de pXmaData del fotograma que contiene la muestra buscada.

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

Devuelve el subfotograma que contiene la muestra.

### Valor devuelto

Tipo: HRESULT

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

## Comentarios

Esta función obtiene los datos necesarios para hacer que el descodificador genere audio a partir de una posición de muestra determinada relativa al principio del bloque de XMA determinado. Esto incluye el desplazamiento de bits del fotograma apropiado y el subfotograma correcto dentro de ese fotograma. Los datos se pueden pasar directamente a la función `XMAPlaybackSetDecodePosition`. 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)
- [GetXmaFrameBitPosition](/es/reference/audio/xma2defs/functions/getxmaframebitposition.md)
- [GetLastXmaFrameBitPosition](/es/reference/audio/xma2defs/functions/getlastxmaframebitposition.md)
- [GetShapeXmaNumSubframesToDecode](/es/reference/audio/shapexmacontext/functions/getshapexmanumsubframestodecode.md)
- [SetSamplePositions](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_setsamplepositions_public.md)