X3DAudioInitialize-Funktion (x3daudio.h)

Legt alle globalen 3D-Audiokonstanten fest.

Syntax

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

Parameter

[in] SpeakerChannelMask

Zuweisung von Kanälen zu Sprecherpositionen. Dieser Wert darf nicht Null sein. Der einzige zulässige Wert auf Xbox 360 ist SPEAKER_XBOX.

[in] SpeedOfSound

Schallgeschwindigkeit in benutzerdefinierten Welteinheiten pro Sekunde. Verwenden Sie diesen Wert nur für Dopplerberechnungen. Sie muss größer oder gleich FLT_MIN sein.

[out] Instance

3D-Audio instance Handle. Verwenden Sie dieses Handle, wenn Sie X3DAudioCalculate aufrufen.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

X3DAUDIO_HANDLE ist eine undurchsichtige Datenstruktur. Da das Betriebssystem keinen zusätzlichen Speicher für das 3D-Audio-instance Handle zuweist, müssen Sie ihn nicht freigeben oder schließen.

Plattformanforderungen

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Windows Phone 8.1: Diese API wird unterstützt.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile x3daudio.h
Bibliothek XAudio2.lib

Siehe auch

Funktionen