> ## 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, relative 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, relative au début du bloc XMA donné. Cela inclut le décalage en bits de la trame appropriée et la sous-trame correcte au sein de cette trame. Les données peuvent être transmises directement à la fonction `XMAPlaybackSetDecodePosition`. Pour plus d'informations sur XMA2, consultez [Vue d'ensemble de XMA2](/fr/build/console-features/audio/overviews/xma2-overview). Pour une vue d'ensemble de l'architecture audio de la XBOX One, consultez **The sound of the future** : [L'architecture audio de la XBOX One](/fr/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/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [GetXmaDecodePositionForSample](/reference/audio/xma2defs/functions/getxmadecodepositionforsample.md)
- [XMA2Defs](/reference/audio/xma2defs/xma2defs_members.md)