AcxStreamBridgeGetTargetStream function (acxstreams.h)

Important

Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The AcxStreamBridgeGetTargetStream function gets the ACXTARGETSTREAM object associated with the input ACXSTREAM object on the specified ACXSTREAMBRIDGE object. For more information about ACX Objects, see ACX - Summary of ACX Objects.

Syntax

ACXTARGETSTREAM AcxStreamBridgeGetTargetStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

Parameters

Bridge

An ACXSTREAMBRIDGE object handle.

Stream

An ACXSTREAM object handle. An ACXSTREAM object represents an audio stream created by a circuit.

Return value

An ACXTARGETSTREAM object handle.

Remarks

An ACXSTREAMBRIDGE object is used by a circuit to propagate stream creation, the stream’s states transitions and DRM settings between the endpoint's circuit stream segments. This object is only used in a multi-circuit (audio composite) scenario.

This DDI can only be called from the driver's input stream property handler context. The caller invokes this DDI to manually send I/O to the out-stream of this stream-bridge object.

The returned target stream is only valid in the context of the input stream property handler. Note that the target stream may be already busy sending other I/O (such as state change) as directed by other ks property stream operations.

Example

Example usage is shown below.

    status = AcxStreamBridgeAddStream(bridge, stream);

    targetStream = AcxStreamBridgeGetTargetStream(bridge, stream);

Requirements

   
Header acxstreams.h

See also