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 états du flux passent 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 (composite audio).
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 de retour
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié. Pour plus d’informations, consultez Using NTSTATUS Values.
Remarques
Les pilotes appellent AcxStreamBridgeAddStream dans les scénarios suivants :
(a) Les pilotes souhaitent sélectionner manuellement ACXSTREAMBRIDGE à utiliser pour acXSTREAM actuel.
(b) les pilotes (et leurs exigences matérielles) ont besoin des acXCIRCUITs de niveau inférieur, c’est-à-dire les circuits plus proches de la broche de pont d’appareil, de prendre 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 ACXCIRCUITs de niveau inférieur.
Pour un type AcxStreamBridgeMux, un seul ACXSTREAM de niveau inférieur est créé indépendamment du nombre d’entrées ACXSTREAMs ajoutées à ce pont. Cela signifie que l’ACXSTREAM de sortie (qui, pour le circuit local, est représenté avec un ACXTARGETSTREAM), est créé uniquement pour le premier ACXSTREAM ajouté à ACXSTREAMBRIDGE. Toute entrée supplémentaire ACXSTREAMs, il vous suffit de faire 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 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 minimale d’ACX : 1.0
Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | acxstreams.h |
| IRQL | PASSIVE_LEVEL |