AcxStreamBridgeRemoveStream, fonction (acxstreams.h)

  • Article

La fonction AcxStreamBridgeRemoveStream supprime l’ACXSTREAM spécifié de l’objet ACXSTREAMBRIDGE . Pour plus d’informations sur les objets ACX, consultez ACX - Résumé des objets ACX.

Syntaxe

NTSTATUS AcxStreamBridgeRemoveStream(
  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

Handle de l’objet ACXSTREAM à supprimer de l’ACXSTREAMBRIDGE.

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

Cette DDI ne peut être appelée qu’à partir du contexte du gestionnaire de nettoyage de flux du pilote. L’appelant appelle cette DDI pour dissocier manuellement un ACXSTREAM d’entrée de l’objet ACXSTREAMBRIDGE spécifié.

Les pilotes appellent AcxStreamBridgeRemoveStream dans les scénarios suivants :

(a) les pilotes souhaitent supprimer manuellement ACXSTREAM de l’ACXSTREAMBRIDGE.

(b) les pilotes (et leurs exigences h/w) ont besoin des ACXSTREAMs de niveau supérieur, c’est-à-dire des flux de circuit plus proches de la broche de pont de streaming, pour prendre des mesures avant les ACXSTREAM de niveau inférieur.

(c) les pilotes doivent prendre des mesures avant et après la sortie de l’ACXSTREAM 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. Les ACXSTREAMs d’entrée supplémentaires prennent simplement 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.

    status = AcxStreamBridgeAddStream(bridge, stream);

    // Get I/O target to send I/O to the target stream.
    targetStream = AcxStreamBridgeGetTargetStream(bridge, stream);
 
    // Target stream is closed if this was last input ACXSTREAM removed.
    status = AcxStreamBridgeRemoveStream(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

Condition requise Valeur
En-tête acxstreams.h
IRQL PASSIVE_LEVEL

Voir aussi