Partager via


Fonction X3DAudioInitialize (x3daudio.h)

Définit toutes les constantes audio 3D globales.

Syntaxe

X3DAUDIO_API_(HRESULT) X3DAudioInitialize(
  [in]  UINT32          SpeakerChannelMask,
  [in]  FLOAT32         SpeedOfSound,
  [out] X3DAUDIO_HANDLE Instance
);

Paramètres

[in] SpeakerChannelMask

Affectation de canaux aux positions d’orateur. Cette valeur ne doit pas être NULL. La seule valeur autorisée sur Xbox 360 est SPEAKER_XBOX.

[in] SpeedOfSound

Vitesse du son, en unités de monde définies par l’utilisateur par seconde. Utilisez cette valeur uniquement pour les calculs doppler. Elle doit être supérieure ou égale à FLT_MIN.

[out] Instance

Poignée de instance audio 3D. Utilisez ce handle lorsque vous appelez X3DAudioCalculate.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

X3DAUDIO_HANDLE est une structure de données opaque. Étant donné que le système d’exploitation n’alloue pas de stockage supplémentaire pour le instance de gestion audio 3D, vous n’avez pas besoin de le libérer ou de le fermer.

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 x3daudio.h
Bibliothèque XAudio2.lib

Voir aussi

Fonctions