XAudio2Create 函数 (xaudio2.h)

创建新的 XAudio2 对象,并返回指向其 IXAudio2 接口的指针。

Syntax

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在发布 和“已选中”版本之间进行选择的标志。 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。

要求

Requirement 价值
目标平台 Windows操作系统
Header xaudio2.h
Library Xaudio2.lib
DLL Windows.Media.Audio.dll

另请参阅

如何:生成基本音频处理图

XAudio2 函数