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

Obtient les données nécessaires pour que le décodeur génère de l'audio à partir d'une position d'échantillon spécifiée par rapport au début du bloc XBOX Media Audio (XMA) spécifié.

## Syntaxe

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

### Paramètres

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

Pointeur vers les blocs XMA.

*nXmaDataBytes*   \
Type : DWORD

Taille de pXmaData, en octets.

*nStreamIndex*   \
Type : DWORD

Flux dans lequel effectuer la recherche.

*nDesiredSample*   \
Type : DWORD

Échantillon recherché.

*pnBitOffset*   \_Out\_\
Type : DWORD\*

Retourne le décalage en bits, dans pXmaData, de la trame qui contient l'échantillon recherché.

*pnSubFrame*   \_Out\_\
Type : DWORD\*

Retourne la sous-trame qui contient l'échantillon.

### Valeur de retour

Type : HRESULT

Code de réussite `S_OK` ou code d'erreur `E_FAIL`.

## Remarques

Cette fonction obtient les données nécessaires pour que le décodeur génère de l'audio à partir d'une position d'échantillon donnée par rapport au début du bloc XMA donné. Cela comprend le décalage en bits de la trame appropriée et la bonne sous-trame dans cette trame. Les données peuvent être passées directement à la fonction `XMAPlaybackSetDecodePosition`. Pour plus d'informations sur XMA2, consultez [Vue d'ensemble de XMA2](/fr-CA/build/console-features/audio/overviews/xma2-overview). Pour une vue d'ensemble de l'architecture audio de la XBOX One, consultez **Le son du futur** : [L'architecture audio de la XBOX One](/fr-CA/build/console-features/audio/overviews/xbox-one-audio-architecture).

## Configuration requise

**En-tête :** xma2defs.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[xma2defs](/fr-CA/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [GetXmaDecodePositionForSample](/reference/audio/xma2defs/functions/getxmadecodepositionforsample.md)
- [XMA2Defs](/reference/audio/xma2defs/xma2defs_members.md)
- [GetXmaBlockContainingSample](/reference/audio/xma2defs/functions/getxmablockcontainingsample.md)
- [XMA2WAVEFORMATEX](/reference/audio/xma2defs/structs/xma2waveformatex.md)
- [GetXmaFrameBitPosition](/reference/audio/xma2defs/functions/getxmaframebitposition.md)