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

用于 CoCreateInstance 函数的 COM 类 ID。

FriendlyName[XAPO_REGISTRATION_STRING_LENGTH]

友好名称，unicode 字符串。

CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH]

版权信息，unicode 字符串。

MajorVersion

主版本号。

MinorVersion

次版本号。

Flags

描述进程行为的一般特征的 XAPO 属性标志。 下表介绍了这些标志。

标志 描述
XAPO_FLAG_INPLACE_SUPPORTED XAPO 支持就地处理：输入流缓冲区和输出流缓冲区可以是相同的缓冲区，具体取决于输入。

例如，考虑可在立体声到 5.1 模式或单声道到单声道模式下运行的效果。 设置为 5.1 的立体声时，它将使用单独的输入和输出缓冲区运行，因为不允许就地进行格式转换。 但是，如果配置为运行单声道到单声道，则可以就地运行相同的 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_REGISTRATION_PROPERTIES 设置XAPO_FLAG_BUFFERCOUNT_MUST_MATCH标志时。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) ;DirectX SDK (XAudio 2.7)

要求

要求 值
Header xapo.h

另请参阅

结构