AcxStreamBridgeRemoveStream, fonction (acxstreams.h)
La fonction AcxStreamRemoveStream 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 é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
Handle vers l’objet ACXSTREAM à supprimer de ACXSTREAMBRIDGE.
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
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 souhaitent supprimer manuellement ACXSTREAM de ACXSTREAMBRIDGE.
(b) les pilotes (et leurs exigences h/w) ont besoin des ACXSTREAMs de niveau supérieur, c’est-à-dire les flux de circuit plus proches de la broche de pont de streaming, pour prendre des mesures avant les ACXSTREAMs de niveau inférieur.
(c) les pilotes doivent prendre des mesures avant et après l’arrêt d’ACXSTREAM.
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. Toutes les entrées supplémentaires ACXSTREAMs tirent 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 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 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 |