X3DAudioInitialize 函式 (x3daudio.h)

設定所有全域 3D 音訊常數。

語法

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

參數

[in] SpeakerChannelMask

將通道指派給說話者位置。 這個值不得為零。 Xbox 360 上唯一允許的值是SPEAKER_XBOX。

[in] SpeedOfSound

每秒用戶定義世界單位的音效速度。 僅針對 doppler 計算使用此值。 它必須大於或等於FLT_MIN。

[out] Instance

3D 音頻實例句柄。 當您呼叫 X3DAudioCalculate 時，請使用此句柄。

傳回值

此函式不會傳回值。

備註

X3DAUDIO_HANDLE 是不透明的數據結構。 因為操作系統不會為 3D 音訊實例句柄配置任何其他記憶體，所以您不需要釋放或關閉它。

平臺需求

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

Windows Phone 8.1：支援此 API。

規格需求

需求	值
目標平台	Windows
標頭	x3daudio.h
程式庫	XAudio2.lib

請參閱

函式