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

一个XAUDIO2_PROCESSOR类型的值，该值指定要使用的 CPU。如果指定了多个位，系统将为每个处理器创建单独的工作线程。

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 在版本和“已检查”版本之间进行选择。 XAUDIO2的 Windows 8 版本中不支持或定义此标志。

注意 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。