Partager via

XAudio2Create, fonction (xaudio2.h)

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 XAUDIO2_PROCESSOR typée qui spécifie l’UC à utiliser. Si plusieurs bits sont spécifiés, le système crée un thread de travail 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éez un thread de travail 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 les threads entre les processeurs. Au lieu de cela, passez la valeur XAUDIO2_DEFAULT_PROCESSOR (voir ci-dessous).
 
La valeur XAUDIO2_DEFAULT_PROCESSOR spéciale entraîne l’utilisation de XAudio2 par défaut.

Valeur retournée

Retourne S_OK si elle réussit, un code d’erreur dans le cas contraire. Consultez les 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 pris en charge un indicateur XAUDIO2_DEBUG_ENGINE à sélectionner entre la version et la version « cochée ». Cet indicateur n’est pas pris en charge ou défini dans la version de 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.

Spécifications

Requirement Valeur
plateforme cible Fenêtres
Header xaudio2.h
Library Xaudio2.lib
DLL Windows.Media.Audio.dll

Voir aussi

Guide pratique pour créer un graphique de traitement audio de base

Fonctions XAudio2

  • Last updated on