structure XAPO_REGISTRATION_PROPERTIES (xapo.h)

Article
03/13/2024

Décrit les caractéristiques générales d’un XAPO. Utilisé avec IXAPO ::GetRegistrationProperties, CXAPOParametersBase ::CXAPOParametersBase et CXAPOBase ::CXAPOBase.

Syntaxe

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;

Membres

clsid

ID de classe COM à utiliser avec la fonction CoCreateInstance.

FriendlyName[XAPO_REGISTRATION_STRING_LENGTH]

Nom convivial, chaîne unicode.

CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH]

Informations de copyright, chaîne unicode.

MajorVersion

Numéro de version principale.

MinorVersion

Numéro de version secondaire.

Flags

Indicateurs de propriété XAPO qui décrivent les caractéristiques générales du comportement des processus. Ces indicateurs sont décrits dans le tableau suivant.

Indicateur	Description
XAPO_FLAG_INPLACE_SUPPORTED	XAPO prend en charge le traitement sur place : la mémoire tampon de flux d’entrée et la mémoire tampon de flux de sortie peuvent être la même mémoire tampon en fonction de l’entrée. Par exemple, considérez un effet qui peut être exécuté en mode stéréo en mode 5.1 ou en mode mono à mono. Lorsqu’elle est définie sur stéréo 5.1, elle est exécutée avec des mémoires tampons d’entrée et de sortie distinctes, car la conversion de format n’est pas autorisée sur place. Toutefois, s’il est configuré pour exécuter mono à mono, le même XAPO peut être exécuté sur place. Ainsi, la même implémentation peut être réutilisée facilement pour différentes configurations d’entrée/sortie, tout en tirant parti du traitement sur place lorsque cela est possible.
XAPO_FLAG_INPLACE_REQUIRED	XAPO nécessite un traitement sur place : la mémoire tampon de flux d’entrée et la mémoire tampon de flux de sortie doivent être la même mémoire tampon. Lorsque le XAPO_FLAG_INPLACE_REQUIRED est utilisé, XAPO ne peut pas effectuer de conversions de format.
XAPO_FLAG_CHANNELS_MUST_MATCH	Le nombre de canaux des flux d’entrée et de sortie doit correspondre.
XAPO_FLAG_FRAMERATE_MUST_MATCH	La fréquence d’images des flux d’entrée et de sortie doit correspondre.
XAPO_FLAG_BITSPERSAMPLE_MUST_MATCH	La profondeur de bits et la taille du conteneur des flux d’entrée et de sortie doivent correspondre.
XAPO_FLAG_BUFFERCOUNT_MUST_MATCH	Le nombre de tampons d’entrée et de sortie doit correspondre, s’applique à XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS. Lorsque l’indicateur XAPO_FLAG_BUFFERCOUNT_MUST_MATCH est défini XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount doit être égal à XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount et XAPO_REGISTRATION_PROPERTIES. MaxInputBufferCount doit être égal à 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

Nombre minimal de flux d’entrée requis pour le traitement.

MaxInputBufferCount

Nombre maximal de flux d’entrée requis pour le traitement.

RemarqueMaxInputBufferCount est actuellement limité à une valeur de 1.

MinOutputBufferCount

Nombre minimal de flux de sortie requis pour le traitement.

MaxOutputBufferCount

Nombre maximal de flux de sortie requis pour le traitement.

RemarqueMaxOutputBufferCount est actuellement limité à la valeur 1.

Remarques

Configuration requise pour la plateforme

Windows 10 (XAudio2.9) ; Windows 8, Windows Phone 8 (XAudio 2.8) ; Kit de développement logiciel (SDK) DirectX (XAudio 2.7)

Configuration requise

Condition requise	Valeur
En-tête	xapo.h

Voir aussi

Structures

Partager via