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。