Функция XAudio2Create (xaudio2.h)

Статья
08/28/2023

Создает новый объект 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 поддерживается.

Требования

Требование	Значение
Целевая платформа	Windows
Header	xaudio2.h
Библиотека	Xaudio2.lib
DLL	Windows.Media.Audio.dll

См. также раздел

Руководство: создание базовой схемы обработки звука

Функции XAudio2

Поделиться через