AcxStreamBridgeRemoveStream, fonction (acxstreams.h)
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 (composite audio).
Stream
Handle de l’objet ACXSTREAM à supprimer de l’ACXSTREAMBRIDGE.
Valeur retournée
Retourne STATUS_SUCCESS
si l’appel a réussi. Sinon, il 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 une entrée ACXSTREAM de l’objet ACXSTREAMBRIDGE spécifié.
Les pilotes appellent AcxStreamBridgeRemoveStream dans les scénarios suivants :
(a) les pilotes veulent supprimer manuellement ACXSTREAM de l’ACXSTREAMBRIDGE.
(b) les pilotes (et leurs exigences en matière de h/w) ont besoin que les ACXSTREAMs de niveau supérieur, c’est-à-dire les flux de circuit se rapprochant de la broche de pont de streaming, prennent des mesures avant les ACXSTREAMs 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, le flux est représenté avec un ACXTARGETSTREAM), est créée uniquement pour le premier ACXSTREAM ajouté à ACXSTREAMBRIDGE. Tout ACXSTREAMs d’entrée supplémentaire prend 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 d’ACX
Version minimale d’ACX : 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 |