创建新的 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值(请参阅下文)。
返回值
如果成功,则返回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 |