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

Utilise une table de recherche spécifiée pour trouver le bloc XBOX Media Audio (XMA) qui contient un échantillon décodé spécifié. Les entrées de la table de recherche d'un fichier XMA sont stockées au format big-endian et doivent parfois être converties avant l'appel de cette fonction.

## Syntaxe

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

### Paramètres

*nBlockCount*   \
Type : DWORD

Nombre de blocs dans le fichier. Identique au nombre d'entrées dans la table de recherche.

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

Pointeur vers les données de la table de recherche.

*nDesiredSample*   \
Type : DWORD

Échantillon décodé à localiser.

*pnBlockContainingSample*   \_Out\_\
Type : DWORD\*

Index du bloc qui contient l'échantillon.

*pnSampleOffsetWithinBlock*   \_Out\_\
Type : DWORD\*

Position de l'échantillon dans ce bloc.

### Valeur de retour

Type : HRESULT

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

## Remarques

Cette fonction utilise le pointeur `pSeekTable` pour trouver le bloc XMA qui contient un échantillon décodé donné. Les entrées de la table de recherche d'un fichier XMA sont stockées au format big-endian.

<Note>Il peut être nécessaire de convertir les entrées de la table de recherche avant d'appeler cette fonction.</Note>

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

- [GetXmaBlockContainingSample](/reference/audio/xma2defs/functions/getxmablockcontainingsample.md)
- [XMA2Defs](/reference/audio/xma2defs/xma2defs_members.md)
- [GetShapeSrcXmaBlocksToSkip](/reference/audio/shapesrccontext/functions/getshapesrcxmablockstoskip.md)
- [GetXmaDecodePositionForSample](/reference/audio/xma2defs/functions/getxmadecodepositionforsample.md)
- [SetShapeSrcXmaBlocksToSkip](/reference/audio/shapesrccontext/functions/setshapesrcxmablockstoskip.md)