Méthode IXAPO::LockForProcess (xapo.h)

Article
08/28/2023

Appelé par XAudio2 pour verrouiller les configurations d’entrée et de sortie d’un XAPO, ce qui lui permet d’effectuer une initialisation finale avant l’appel de Process sur le thread en temps réel.

Syntaxe

HRESULT LockForProcess(
  UINT32                               InputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pInputLockedParameters,
  UINT32                               OutputLockedParameterCount,
  const XAPO_LOCKFORPROCESS_PARAMETERS *pOutputLockedParameters
);

Paramètres

InputLockedParameterCount

Nombre d’éléments dans ppInputLockedParameters. Doit être dans le XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount et XAPO_REGISTRATION_PROPERTIES. Valeurs MaxInputBufferCount passées à CXAPOBase::CXAPOBase.

pInputLockedParameters

Tableau de structures XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS d’entrée. pInputLockedParameters peut avoir la valeur NULL si InputLockedParameterCount a la valeur 0, sinon il doit avoir des éléments InputLockedParameterCount .

OutputLockedParameterCount

Nombre d’éléments dans ppOutputLockedParameters. Doit être dans le XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount et XAPO_REGISTRATION_PROPERTIES. Valeurs MaxOutputBufferCount passées à CXAPOBase::CXAPOBase. Si l’indicateur XAPO_FLAG_BUFFERCOUNT_MUST_MATCH a été spécifié dans XAPO_REGISTRATION_PROPERTIES. Les indicateurs puis OutputLockedParameterCount doivent être égal à InputLockedParameterCount.

pOutputLockedParameters

Tableau de structures de XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS de sortie. pOutputLockedParameters peut avoir la valeur NULL si OutputLockedParameterCount a la valeur 0, sinon il doit avoir des éléments OutputLockedParameterCount .

Valeur retournée

Retourne S_OK en cas de réussite, un code d’erreur dans le cas contraire.

Remarques

Une fois verrouillé, la configuration d’entrée et de sortie et tous les autres paramètres verrouillés restent constants jusqu’à ce que UnLockForProcess soit appelé. Une fois qu’un XAPO est verrouillé, d’autres appels à LockForProcess n’ont aucun effet tant que la fonction UnLockForProcess n’est pas appelée.

Un XAPO indique les formats spécifiques qu’il prend en charge par le biais de son implémentation des méthodes IsInputFormatSupported et IsOutputFormatSupported . Un XAPO doit affirmer que les configurations d’entrée et de sortie sont prises en charge et que toute initialisation spécifique à l’effet requise est terminée. Les méthodes IsInputFormatSupported, IsOutputFormatSupported et Initialize doivent être utilisées si nécessaire avant d’appeler cette méthode.

Étant donné que Process est une méthode non bloquante, toutes les mémoires tampons internes requises pour Process doivent être allouées dans LockForProcess.

Le processus n’est jamais appelé avant que LockForProcess ne retourne correctement.

LockForProcess est appelé directement par XAudio2 et ne doit pas être appelé par le code client.

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)

Spécifications


Plateforme cible	Windows
En-tête	xapo.h

Voir aussi

IXAPO

Partager via