XAPO_REGISTRATION_PROPERTIES struttura (xapo.h)

Articolo
08/28/2023

Descrive le caratteristiche generali di un XAPO. Usato con IXAPO::GetRegistrationProperties, CXAPOParametersBase::CXAPOParametersBase e CXAPOBase::CXAPOBase::CXAPOBase.

Sintassi

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

ID classe COM da usare con la funzione CoCreateInstance.

FriendlyName[XAPO_REGISTRATION_STRING_LENGTH]

Nome descrittivo, stringa unicode.

CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH]

Informazioni sul copyright, stringa unicode.

MajorVersion

Numero di versione principale.

MinorVersion

Numero di versione secondario.

Flags

Flag delle proprietà XAPO che descrivono le caratteristiche generali del comportamento del processo. Questi flag sono descritti nella tabella seguente.

Flag	Descrizione
XAPO_FLAG_INPLACE_SUPPORTED	XAPO supporta l'elaborazione sul posto: il buffer di flusso di input e il buffer di flusso di output possono essere lo stesso buffer a seconda dell'input. Si consideri ad esempio un effetto che può essere eseguito in stereo a 5,1 modalità o mono in modalità mono. Se impostato su stereo su 5.1, verrà eseguito con buffer di input e output separati come conversione del formato non è consentita sul posto. Tuttavia, se configurato per eseguire mono in mono, è possibile eseguire lo stesso XAPO sul posto. Pertanto, la stessa implementazione può essere facilmente riutilizzata per varie configurazioni di input/output, sfruttando al contempo l'elaborazione sul posto quando possibile.
XAPO_FLAG_INPLACE_REQUIRED	XAPO richiede l'elaborazione sul posto: il buffer di flusso di input e il buffer di flusso di output devono essere lo stesso buffer. Quando la XAPO_FLAG_INPLACE_REQUIRED viene usata la XAPO non può eseguire conversioni di formato.
XAPO_FLAG_CHANNELS_MUST_MATCH	Il numero di canali dei flussi di input e di output deve corrispondere.
XAPO_FLAG_FRAMERATE_MUST_MATCH	Il framerate di flussi di input e di output deve corrispondere.
XAPO_FLAG_BITSPERSAMPLE_MUST_MATCH	La profondità di bit e le dimensioni dei contenitori dei flussi di input e di output devono corrispondere.
XAPO_FLAG_BUFFERCOUNT_MUST_MATCH	Il numero di buffer di input e di output deve corrispondere, si applica a XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS. Quando il flag di XAPO_FLAG_BUFFERCOUNT_MUST_MATCH è impostato XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount deve essere uguale XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount e XAPO_REGISTRATION_PROPERTIES. MaxInputBufferCount deve essere uguale 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

Numero minimo di flussi di input necessari per l'elaborazione.

MaxInputBufferCount

Numero massimo di flussi di input necessari per l'elaborazione.

NotaMaxInputBufferCount è attualmente limitato a un valore pari a 1.

MinOutputBufferCount

Numero minimo di flussi di output necessari per l'elaborazione.

MaxOutputBufferCount

Numero massimo di flussi di output necessari per l'elaborazione.

NotaMaxOutputBufferCount è attualmente limitato a un valore pari a 1.

Commenti

Requisiti della piattaforma

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

Requisiti

Requisito	Valore
Intestazione	xapo.h

Vedi anche

Strutture

Condividi tramite