IAudioProcessingObjectConfiguration ::LockForProcess, méthode (audioenginebaseapo.h)

Article
02/28/2024

La LockForProcess méthode est utilisée pour vérifier que l’APO est verrouillé et prêt à traiter les données.

Syntaxe

HRESULT LockForProcess(
  [in] UINT32                    u32NumInputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppInputConnections,
  [in] UINT32                    u32NumOutputConnections,
  [in] APO_CONNECTION_DESCRIPTOR **ppOutputConnections
);

Paramètres

[in] u32NumInputConnections

Nombre de connexions d’entrée attachées à cette APO.

[in] ppInputConnections

Descripteur de connexion pour chaque connexion d’entrée attachée à cette APO.

[in] u32NumOutputConnections

Nombre de connexions de sortie attachées à cette APO.

[in] ppOutputConnections

Descripteur de connexion pour chaque connexion de sortie attachée à cette APO.

Valeur retournée

La LockForProcess méthode retourne une valeur de S_OK si l’appel est terminé avec succès. À ce stade, l’APO est verrouillé et est prêt à traiter les données.

Code de retour	Description
E_POINTER	Un pointeur non valide a été passé à la fonction.
APOERR_INVALID_CONNECITON_FORMAT	Format de connexion non valide.
APOERR_NUM_CONNECTIONS_INVALID	Nombre de connexions d’entrée ou de sortie non valides sur cette APO.
APOERR_APO_LOCKED	APO est déjà verrouillé.
Autres HRESULTS	Ces échecs seront suivis par le moteur audio.

Remarques

Lorsque la LockForProcess méthode est appelée, elle effectue d’abord une case activée interne pour voir si l’APO a été initialisé et est prêt à traiter les données. Chaque APO a des exigences d’initialisation différentes. Chaque APO doit donc définir sa propre méthode Initialize si nécessaire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible avec Windows Vista et les versions ultérieures du système d’exploitation Windows.
Plateforme cible	Universal
En-tête	audioenginebaseapo.h
Bibliothèque	Audioenginebaseapo.idl
IRQL	Tous les niveaux

Partager via