XAudio2Create, fonction (xaudio2.h)

Article
03/04/2024

Crée un objet XAudio2 et retourne un pointeur vers son interface IXAudio2 .

Syntaxe

HRESULT XAudio2Create(
  [out] IXAudio2          **ppXAudio2,
  [in]  UINT32            Flags,
  [in]  XAUDIO2_PROCESSOR XAudio2Processor
);

Paramètres

[out] ppXAudio2

Si l’opération réussit, retourne un pointeur vers un objet IXAudio2 .

[in] Flags

Indicateurs qui spécifient le comportement de l’objet IXAudio2 . La valeur de ce paramètre doit être 0.

[in] XAudio2Processor

Valeur de type XAUDIO2_PROCESSOR qui spécifie le processeur à utiliser. Si plusieurs bits sont spécifiés, le système crée un thread worker distinct pour chaque processeur.

XAUDIO2_PROCESSOR valeur par défaut est XAUDIO2_DEFAULT_PROCESSOR.

Avertissement Si vous spécifiez XAUDIO2_ANY_PROCESSOR, le système utilise tous les processeurs de l’appareil et, comme indiqué ci-dessus, crée un thread worker pour chaque processeur.

Note La spécification d’un processeur doit généralement être évitée, car elle peut interférer avec la capacité du planificateur à planifier efficacement des threads entre les processeurs. Au lieu de cela, transmettez la valeur XAUDIO2_DEFAULT_PROCESSOR (voir ci-dessous).

La valeur XAUDIO2_DEFAULT_PROCESSOR spéciale oblige XAudio2 à utiliser son processeur par défaut.

Valeur retournée

Retourne S_OK en cas de réussite, un code d’erreur dans le cas contraire. Consultez Codes d’erreur XAudio2 pour obtenir des descriptions des codes d’erreur spécifiques à XAudio2.

Remarques

Les versions du Kit de développement logiciel (SDK) DirectX de XAUDIO2 prenaient en charge un indicateur XAUDIO2_DEBUG_ENGINE pour sélectionner entre la version et la version « vérifiée ». Cet indicateur n’est pas pris en charge ou défini dans la version Windows 8 de XAUDIO2.

Note Aucune version du Kit de développement logiciel (SDK) DirectX ne contient la bibliothèque d’importation xaudio2.lib. Les versions du Kit de développement logiciel (SDK) DirectX utilisent COM pour créer un objet XAudio2 .

Configuration requise pour la plateforme

Windows 10 (XAudio2.9) ; Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)

Windows Phone 8.1 : Cette API est prise en charge.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	xaudio2.h
Bibliothèque	Xaudio2.lib
DLL	Windows.Media.Audio.dll

Voir aussi

Procédure : créer un graphique de traitement audio de base

Fonctions XAudio2

Partager via