Edit

Share via

AcxStreamBridgeGetTargetStream function (acxstreams.h)

  • Article

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);

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement Value
Header acxstreams.h
IRQL PASSIVE_LEVEL

See also