XAPO_REGISTRATION_PROPERTIES structure

Describes general characteristics of an XAPO. Used with IXAPO::GetRegistrationProperties, CXAPOParametersBase::CXAPOParametersBase, and CXAPOBase::CXAPOBase.

Syntax


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;

Members

clsid

COM class ID for use with the CoCreateInstance function.

FriendlyName

Friendly name, a unicode string.

CopyrightInfo

Copyright information, a unicode string.

MajorVersion

Major version number.

MinorVersion

Minor version number.

Flags

XAPO property flags that describe the general characteristics of process behavior. These flags are described in the following table.

FlagDescription
XAPO_FLAG_INPLACE_SUPPORTED

XAPO supports in-place processing: the input stream buffer and output stream buffer can be the same buffer depending on the input.

For example, consider an effect which may be ran in stereo to 5.1 mode or mono to mono mode. When set to stereo to 5.1, it will be run with separate input and output buffers as format conversion is not permitted in-place. However, if configured to run mono to mono, the same XAPO can be run in-place. Thus the same implementation may be conveniently reused for various input/output configurations, while taking advantage of in-place processing when possible.

XAPO_FLAG_INPLACE_REQUIREDXAPO requires in-place processing: the input stream buffer and output stream buffer must be the same buffer. When the XAPO_FLAG_INPLACE_REQUIRED is used the XAPO cannot perform format conversions.
XAPO_FLAG_CHANNELS_MUST_MATCHChannel count of the input and output streams must match.
XAPO_FLAG_FRAMERATE_MUST_MATCHFramerate of input and output streams must match.
XAPO_FLAG_BITSPERSAMPLE_MUST_MATCHBit depth and container size of input and output streams must match.
XAPO_FLAG_BUFFERCOUNT_MUST_MATCHNumber of input and output buffers must match, applies to XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS. When the XAPO_FLAG_BUFFERCOUNT_MUST_MATCH flag is set XAPO_REGISTRATION_PROPERTIES.MinInputBufferCount must equal XAPO_REGISTRATION_PROPERTIES.MinOutputBufferCount and XAPO_REGISTRATION_PROPERTIES.MaxInputBufferCount must equal XAPO_REGISTRATION_PROPERTIES.MaxOutputBufferCount.
XAPOBASE_DEFAULT_FLAGXAPO_FLAG_CHANNELS_MUST_MATCH | XAPO_FLAG_FRAMERATE_MUST_MATCH | XAPO_FLAG_BITSPERSAMPLE_MUST_MATCH | XAPO_FLAG_BUFFERCOUNT_MUST_MATCH | XAPO_FLAG_INPLACE_SUPPORTED

 

MinInputBufferCount

Minimum number of input streams required for processing.

MaxInputBufferCount

Maximum number of input streams required for processing.

Note  MaxInputBufferCount is currently limited to a value of 1.

MinOutputBufferCount

Minimum number of output streams required for processing.

MaxOutputBufferCount

Maximum number of output streams required for processing.

Note  MaxOutputBufferCount is currently limited to a value of 1.

Remarks

Platform Requirements

Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Requirements

Header

Xapo.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft