Функция 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, указывающее, какой ЦП следует использовать. Если задано несколько битов, система создаст отдельный рабочий поток для каждого процессора.

XAUDIO2_PROCESSOR значение по умолчанию — XAUDIO2_DEFAULT_PROCESSOR.

Предупреждение Если указать XAUDIO2_ANY_PROCESSOR, система будет использовать все процессоры устройства и, как отмечалось выше, создайте рабочий поток для каждого процессора.
 
Заметка Как правило, следует избегать указания процессора, так как это может препятствовать возможности планировщика эффективно планировать потоки между процессорами. Вместо этого передайте значение XAUDIO2_DEFAULT_PROCESSOR (см. ниже).
 
Значение специального XAUDIO2_DEFAULT_PROCESSOR приводит к использованию обработчика XAudio2 по умолчанию.

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения, код ошибки в противном случае. Коды ошибок XAudio2 см. в разделе "Коды ошибок XAudio2".

Замечания

Версии пакета SDK DirectX XAUDIO2 поддерживают флаг XAUDIO2_DEBUG_ENGINE выбрать версию выпуска и "проверенной". Этот флаг не поддерживается или не определен в версии Windows 8 XAUDIO2.

Заметка Версия пакета SDK DirectX не содержит библиотеку импорта xaudio2.lib. Версии пакета SDK DirectX используют COM для создания нового объекта XAudio2 .
 

Требования к платформе

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK DirectX (XAudio 2.7)

Windows Phone 8.1: Этот API поддерживается.

Требования

Требование Ценность
целевая платформа Виндоус
Header xaudio2.h
Library Xaudio2.lib
DLL Windows.Media.Audio.dll

См. также

Практическое руководство. Создание базового графа обработки звука

Функции XAudio2

  • Last updated on