estrutura XAPO_REGISTRATION_PROPERTIES (xapo.h)

Descreve as características gerais de um XAPO. Usado com IXAPO::GetRegistrationProperties, CXAPOParametersBase::CXAPOParametersBase e CXAPOBase::CXAPOBase.

Sintaxe

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;

Membros

clsid

ID de classe COM para uso com a função CoCreateInstance.

FriendlyName[XAPO_REGISTRATION_STRING_LENGTH]

Nome amigável, uma cadeia de caracteres unicode.

CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH]

Informações de direitos autorais, uma cadeia de caracteres unicode.

MajorVersion

Número de versão principal.

MinorVersion

Número de versão secundária.

Flags

Sinalizadores de propriedade XAPO que descrevem as características gerais do comportamento do processo. Esses sinalizadores são descritos na tabela a seguir.

Sinalizador Descrição
XAPO_FLAG_INPLACE_SUPPORTED O XAPO dá suporte ao processamento in-loco: o buffer de fluxo de entrada e o buffer de fluxo de saída podem ser o mesmo buffer, dependendo da entrada.

Por exemplo, considere um efeito que pode ser executado no modo estéreo para o modo 5.1 ou mono para o modo mono. Quando definido como estéreo como 5.1, ele será executado com buffers de entrada e saída separados, pois a conversão de formato não é permitida no local. No entanto, se configurado para executar mono para mono, o mesmo XAPO poderá ser executado in-loco. Portanto, a mesma implementação pode ser reutilizado convenientemente para várias configurações de entrada/saída, aproveitando o processamento in-loco quando possível.

XAPO_FLAG_INPLACE_REQUIRED O XAPO requer processamento in-loco: o buffer de fluxo de entrada e o buffer de fluxo de saída devem ser o mesmo buffer. Quando o XAPO_FLAG_INPLACE_REQUIRED é usado, o XAPO não pode executar conversões de formato.
XAPO_FLAG_CHANNELS_MUST_MATCH A contagem de canais dos fluxos de entrada e saída deve corresponder.
XAPO_FLAG_FRAMERATE_MUST_MATCH A taxa de quadros de fluxos de entrada e saída deve corresponder.
XAPO_FLAG_BITSPERSAMPLE_MUST_MATCH A profundidade do bit e o tamanho do contêiner dos fluxos de entrada e saída devem corresponder.
XAPO_FLAG_BUFFERCOUNT_MUST_MATCH O número de buffers de entrada e saída deve corresponder, aplica-se a XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS. Quando o sinalizador XAPO_FLAG_BUFFERCOUNT_MUST_MATCH é definido XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount deve ser igual a XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount e XAPO_REGISTRATION_PROPERTIES. MaxInputBufferCount deve ser igual a 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

Número mínimo de fluxos de entrada necessários para processamento.

MaxInputBufferCount

Número máximo de fluxos de entrada necessários para processamento.

ObservaçãoMaxInputBufferCount está atualmente limitado a um valor de 1.
 

MinOutputBufferCount

Número mínimo de fluxos de saída necessários para processamento.

MaxOutputBufferCount

Número máximo de fluxos de saída necessários para processamento.

ObservaçãoMaxOutputBufferCount está atualmente limitado a um valor de 1.
 

Comentários

Requisitos de plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK do DirectX (XAudio 2.7)

Requisitos

Requisito Valor
Cabeçalho xapo.h

Confira também

Estruturas