XAPO_REGISTRATION_PROPERTIES-Struktur (xapo.h)

Artikel
03/04/2024

Beschreibt allgemeine Merkmale eines XAPO. Wird mit IXAPO::GetRegistrationProperties, CXAPOParametersBase::CXAPOParametersBase und CXAPOBase::CXAPOBase verwendet.

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;

Member

clsid

COM-Klassen-ID zur Verwendung mit der CoCreateInstance-Funktion.

FriendlyName[XAPO_REGISTRATION_STRING_LENGTH]

Anzeigename, eine Unicode-Zeichenfolge.

CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH]

Copyrightinformationen, eine Unicode-Zeichenfolge.

MajorVersion

Hauptversionsnummer.

MinorVersion

Nebenversionsnummer.

Flags

XAPO-Eigenschaftsflags, die die allgemeinen Merkmale des Prozessverhaltens beschreiben. Diese Flags werden in der folgenden Tabelle beschrieben.

Flag	Beschreibung
XAPO_FLAG_INPLACE_SUPPORTED	XAPO unterstützt die direkte Verarbeitung: Der Eingabedatenstrompuffer und der Ausgabestreampuffer können je nach Eingabe derselbe Puffer sein. Betrachten Sie beispielsweise einen Effekt, der im Stereomodus 5.1 oder im Mono-in-Mono-Modus ausgeführt werden kann. Wenn die Einstellung auf Stereo auf 5.1 festgelegt ist, wird es mit separaten Ein- und Ausgabepuffern ausgeführt, da die Formatkonvertierung nicht an ortsbezogener Stelle zulässig ist. Wenn sie jedoch für die Ausführung von Mono zu Mono konfiguriert ist, kann dasselbe XAPO-Projekt auch tatsächlich ausgeführt werden. Daher kann dieselbe Implementierung bequem für verschiedene Eingabe-/Ausgabekonfigurationen wiederverwendet werden, während nach Möglichkeit die Direkte Verarbeitung genutzt wird.
XAPO_FLAG_INPLACE_REQUIRED	XAPO erfordert eine direkte Verarbeitung: Der Eingabedatenstrompuffer und der Ausgabedatenstrompuffer müssen derselbe Puffer sein. Wenn die XAPO_FLAG_INPLACE_REQUIRED verwendet wird, kann das XAPO keine Formatkonvertierungen durchführen.
XAPO_FLAG_CHANNELS_MUST_MATCH	Die Kanalanzahl der Eingabe- und Ausgabestreams muss übereinstimmen.
XAPO_FLAG_FRAMERATE_MUST_MATCH	Die Framerate von Eingabe- und Ausgabedatenströmen muss übereinstimmen.
XAPO_FLAG_BITSPERSAMPLE_MUST_MATCH	Bittiefe und Containergröße von Eingabe- und Ausgabedatenströmen müssen übereinstimmen.
XAPO_FLAG_BUFFERCOUNT_MUST_MATCH	Die Anzahl der Eingabe- und Ausgabepuffer, die übereinstimmen müssen, gilt für XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS. Wenn das XAPO_FLAG_BUFFERCOUNT_MUST_MATCH-Flag XAPO_REGISTRATION_PROPERTIES festgelegt ist. MinInputBufferCount muss gleich XAPO_REGISTRATION_PROPERTIES sein. MinOutputBufferCount und XAPO_REGISTRATION_PROPERTIES. MaxInputBufferCount muss gleich 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

Mindestanzahl von Eingabedatenströmen, die für die Verarbeitung erforderlich sind.

MaxInputBufferCount

Maximale Anzahl von Eingabedatenströmen, die für die Verarbeitung erforderlich sind.

HinweisMaxInputBufferCount ist derzeit auf den Wert 1 beschränkt.

MinOutputBufferCount

Mindestanzahl von Ausgabedatenströmen, die für die Verarbeitung erforderlich sind.

MaxOutputBufferCount

Maximale Anzahl von Ausgabedatenströmen, die für die Verarbeitung erforderlich sind.

HinweisMaxOutputBufferCount ist derzeit auf den Wert 1 beschränkt.

Hinweise

Plattformanforderungen

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

Anforderungen

Anforderung	Wert
Header	xapo.h

Siehe auch

Strukturen

Freigeben über