AcxStreamBridgeAddStream, fonction (acxstreams.h)

La fonction AcxStreamBridgeAddStream ajoute un ACXSTREAM existant à un ACXSTREAMBRIDGE existant. Pour plus d’informations sur les objets ACX, consultez ACX - Résumé des objets ACX.

Syntaxe

NTSTATUS AcxStreamBridgeAddStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

Paramètres

Bridge

Un objet ACXSTREAMBRIDGE est utilisé par un circuit pour propager la création de flux, les transitions d’états du flux et les paramètres DRM entre les segments de flux de circuit du point de terminaison. Cet objet est utilisé uniquement dans un scénario multi-circuit (audio composite).

Stream

Un objet ACXSTREAM représente un flux audio créé par un circuit. Le flux est composé d’une liste d’éléments créés en fonction des éléments du circuit parent.

Valeur retournée

Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.

Remarques

Les pilotes appellent AcxStreamBridgeAddStream dans ces scénarios :

(a) les pilotes souhaitent sélectionner manuellement l’ACXSTREAMBRIDGE à utiliser pour l’ACXSTREAM actuel.

(b) les pilotes (et leur configuration matérielle requise) ont besoin que les ACXCIRCUIT de niveau inférieur, c’est-à-dire les circuits plus proches de la broche du pont de périphérique, prennent des mesures avant que les ACXCIRCUITs de niveau supérieur prennent des mesures.

(c) les pilotes doivent prendre des mesures avant et après les ACXCIRCUIT de niveau inférieur.

Pour un type AcxStreamBridgeMux, un seul ACXSTREAM de niveau inférieur est créé indépendamment du nombre d’ACXSTREAMs d’entrée ajoutés à ce pont. Cela signifie que la sortie ACXSTREAM (qui, pour le circuit local, représente le flux avec un ACXTARGETSTREAM), est créée uniquement pour le premier ACXSTREAM ajouté à ACXSTREAMBRIDGE. Toute entrée ACXSTREAMs supplémentaire, il suffit de prendre une référence à cet ACXTARGETSTREAM existant.

Pour un type AcxSTreamBridgeMux, la sortie ACXTARGETSTREAM est supprimée lorsque la dernière entrée ACXSTREAM est supprimée de l’ACXSTREAMBRIDGE avec AcxStreamBridgeRemoveStream.

Exemple

L’exemple d’utilisation est illustré ci-dessous. Le code de gestion des erreurs n’est pas affiché.

        status = AcxStreamBridgeCreate(Circuit, &attributes, &bridgeCfg, &bridge);

        // Pin ID 1 is the bridge pin in this example.
        bridgePin = AcxCircuitGetPinById(Circuit, 1);
        
        status = AcxPinAddStreamBridges(bridgePin, &bridge, 1);

        status = AcxStreamBridgeAddStream(bridge, stream);

Configuration requise pour ACX

Version ACX minimale : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Voir aussi

• En-tête acxstreams.h