共用方式為


XAudio2Create 函式 (xaudio2.h)

建立新的 XAudio2 物件,並傳回其 IXAudio2 介面的指標。

語法

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

參數

[out] ppXAudio2

如果作業成功,則會傳回 IXAudio2 對象的指標。

[in] Flags

指定 IXAudio2 對象行為的旗標。 此參數的值必須是 0。

[in] XAudio2Processor

指定要使用的 CPU 的XAUDIO2_PROCESSOR型別值。 如果指定多個位,系統會為每個處理器建立個別的背景工作線程。

XAUDIO2_PROCESSOR 預設值為 XAUDIO2_DEFAULT_PROCESSOR。

警告 如果您指定 XAUDIO2_ANY_PROCESSOR,系統會使用所有裝置的處理器,如上所述,為每個處理器建立背景工作線程。
 
注意 通常應該避免指定處理器,因為它可能會干擾排程器能夠有效地跨處理器排程線程。 相反地,請傳遞XAUDIO2_DEFAULT_PROCESSOR值, (請參閱下方) 。
 
特殊XAUDIO2_DEFAULT_PROCESSOR值會導致 XAudio2 使用其預設處理器。

傳回值

如果成功,則傳回S_OK,否則傳回錯誤碼。 如需 XAudio2 特定錯誤碼的描述,請參閱 XAudio2 錯誤 碼。

備註

XAUDIO2的 DirectX SDK 版本支援旗標 XAUDIO2_DEBUG_ENGINE ,以在版本與「已核取」版本之間選取。 Windows 8 版本的 XAUDIO2 中不支援或定義此旗標。

注意 沒有任何版本的 DirectX SDK 包含 xaudio2.lib 匯入連結庫。 DirectX SDK 版本會使用 COM 來建立新的 XAudio2 物件。
 

平臺需求

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

Windows Phone 8.1:支援此 API。

規格需求

需求
目標平台 Windows
標頭 xaudio2.h
程式庫 Xaudio2.lib
Dll Windows.Media.Audio.dll

另請參閱

使用方法:建立基本音訊處理圖形

XAudio2 函式