структура XAPO_REGISTRATION_PROPERTIES (xapo.h)

  • Статья

Описание общих характеристик XAPO. Используется с IXAPO::GetRegistrationProperties, CXAPOParametersBase::CXAPOParametersBase и CXAPOBase::CXAPOBase.

Синтаксис

typedef struct XAPO_REGISTRATION_PROPERTIES {
  CLSID  clsid;
  WCHAR  FriendlyName[XAPO_REGISTRATION_STRING_LENGTH];
  WCHAR  CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH];
  UINT32 MajorVersion;
  UINT32 MinorVersion;
  UINT32 Flags;
  UINT32 MinInputBufferCount;
  UINT32 MaxInputBufferCount;
  UINT32 MinOutputBufferCount;
  UINT32 MaxOutputBufferCount;
} XAPO_REGISTRATION_PROPERTIES;

Члены

clsid

Идентификатор класса COM для использования с функцией CoCreateInstance.

FriendlyName[XAPO_REGISTRATION_STRING_LENGTH]

Понятное имя, строка Юникода.

CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH]

Сведения об авторских правах, строка Юникода.

MajorVersion

Основной номер версии.

MinorVersion

Дополнительный номер версии.

Flags

Флаги свойств XAPO, описывающие общие характеристики поведения процесса. Эти флаги описаны в следующей таблице.

Flag Описание
XAPO_FLAG_INPLACE_SUPPORTED XAPO поддерживает обработку на месте: буфер входного и выходного потока могут быть одинаковыми буферами в зависимости от входных данных.

Например, рассмотрим эффект, который может выполняться в режиме стерео до 5.1 или в режиме моно в моно. Если для стерео задано значение 5.1, он будет выполняться с отдельными входными и выходными буферами, так как преобразование формата на месте запрещено. Однако если настроено выполнение mono в mono, то один и тот же объект XAPO можно запустить на месте. Таким образом, одну и ту же реализацию можно использовать повторно для различных конфигураций ввода-вывода, при этом по возможности пользуясь преимуществами обработки на месте.
XAPO_FLAG_INPLACE_REQUIRED XAPO требует обработки на месте: буфер входного и выходного потока должны быть одинаковыми. При использовании XAPO_FLAG_INPLACE_REQUIRED XAPO не может выполнять преобразования формата.
XAPO_FLAG_CHANNELS_MUST_MATCH Количество каналов входных и выходных потоков должно совпадать.
XAPO_FLAG_FRAMERATE_MUST_MATCH Частота кадров входных и выходных потоков должна совпадать.
XAPO_FLAG_BITSPERSAMPLE_MUST_MATCH Битовая глубина и размер контейнера входных и выходных потоков должны совпадать.
XAPO_FLAG_BUFFERCOUNT_MUST_MATCH Количество входных и выходных буферов должно совпадать, применяется к XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS. Если флаг XAPO_FLAG_BUFFERCOUNT_MUST_MATCH установлен XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount должен быть равен XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount и XAPO_REGISTRATION_PROPERTIES. MaxInputBufferCount должен быть равен XAPO_REGISTRATION_PROPERTIES. MaxOutputBufferCount.
XAPOBASE_DEFAULT_FLAG XAPO_FLAG_CHANNELS_MUST_MATCH | XAPO_FLAG_FRAMERATE_MUST_MATCH | XAPO_FLAG_BITSPERSAMPLE_MUST_MATCH | XAPO_FLAG_BUFFERCOUNT_MUST_MATCH | XAPO_FLAG_INPLACE_SUPPORTED

MinInputBufferCount

Минимальное количество входных потоков, необходимых для обработки.

MaxInputBufferCount

Максимальное количество входных потоков, необходимых для обработки.

Примечание. Значение MaxInputBufferCount в настоящее время ограничено значением 1.
 

MinOutputBufferCount

Минимальное количество выходных потоков, необходимых для обработки.

MaxOutputBufferCount

Максимальное количество потоков вывода, необходимых для обработки.

Примечание. Значение MaxOutputBufferCount в настоящее время ограничено значением 1.
 

Комментарии

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

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

Требования

Требование Значение
Заголовок xapo.h

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

Структуры