1.4.2 OcaMediaTransportNetwork

Class Hierarchy:

OcaRoot : OcaApplicationNetwork : OcaMediaTransportNetwork

class OcaMediaTransportNetwork : OcaApplicationNetwork

Properties:

OcaDB AlignmentGain

Default value of AlignmentGain for newly-created OcaMediaSinkConnectors attached to this network. The min and max values of this property define respectively the lowest and highest alignment level values that may be specified when adding sink connectors to this network.

This property has id 3.8.

OcaDBFS AlignmentLevel

Default alignment level value for newly-created OcaMedia{Source|Sink}Connector elements. The min and max values of this property define respectively the lowest and highest alignment level values that may be specified when adding connectors to this network.

This property has id 3.7.

static const OcaClassID ClassID = "1.4.2"

This property is an override of the OcaRoot property.

This property has id 1.1.

static const OcaClassVersionNumber ClassVersion = 1

This property is an override of the OcaRoot property.

This property has id 1.2.

OcaUint16 MaxPinsPerConnector

The maximum number of pins (channels) in a connector that this network will support.

This property has id 3.5.

OcaUint16 MaxPortsPerPin

The maximum number of ports per pin that this network will support. Value of zero indicates there is no specific limit.

This property has id 3.6.

OcaUint16 MaxSinkConnectors

The maximum number of sink connectors this media transport network can have (read-only property).

This property has id 3.4.

OcaUint16 MaxSourceConnectors

The maximum number of source connectors this media transport network can have (read-only property).

This property has id 3.3.

OcaList<OcaPort> Ports

The list of ports this network has. Note that these represent network channels of the media transport network. Each input port represents a source (transmit) network channel, each output port represents a sink (receive) network channel. Such network channels are directly linked to the ports, so the first input port represents the first source network channel, etc.

This property has id 3.2.

OcaNetworkMediaProtocol Protocol

Type of media transport protocol used by the network.

This property has id 3.1.

Properties inherited from 1.4 OcaApplicationNetwork:

Methods:

OcaStatus GetMediaProtocol(OcaNetworkMediaProtocol &Protocol)

Gets the network’s Protocol property. Return status indicates whether the operation was successful.

This method has id 3.1.

OcaStatus GetPorts(OcaList<OcaPort> &OcaPorts)

Gets the list of ports owned by the MediaTransportNetwork object (representing the source and sink network channels). The return value indicates whether the list was successfully retrieved.

This method has id 3.2.

OcaStatus GetPortName(OcaPortID PortID, OcaString &Name)

Gets the name of the designated port. The return value indicates whether the name was successfully retrieved.

This method has id 3.3.

  • PortID: Input parameter.

  • Name: Output parameter.

OcaStatus SetPortName(OcaPortID PortID, OcaString Name)

Sets the name of the designated port. The return value indicates whether the name was successfully set.

This method has id 3.4.

OcaStatus GetMaxSourceConnectors(OcaUint16 &MaxSourceConnectors)

Gets the maximum number of source connectors this media transport network supports.

This method has id 3.5.

OcaStatus GetMaxSinkConnectors(OcaUint16 &MaxSinkConnectors)

Gets the maximum number of source connectors this media transport network supports.

This method has id 3.6.

OcaStatus GetMaxPinsPerConnector(OcaUint16 &MaxPins)

Gets the maximum number of ports per pin this media transport network supports.

This method has id 3.7.

OcaStatus GetMaxPortsPerPin(OcaUint16 &MaxPins)

Gets the maximum number of pins (channels) per connector this media transport network supports.

This method has id 3.8.

OcaStatus GetSourceConnectors(OcaList<OcaMediaSourceConnector> &Connectors)

Gets the descriptors of all the source (output) connectors collected by this network object. Return status indicates success of the operation.

This method has id 3.9.

OcaStatus GetSourceConnector(OcaMediaConnectorID ID, OcaMediaSourceConnector &Connector)

Retrieves the descriptor of a given source connector. Return status indicates the success of the operation.

This method has id 3.10.

OcaStatus GetSinkConnectors(OcaList<OcaMediaSinkConnector> &Connectors)

Gets the descriptors of all the sink (output) connectors collected by this network object. Return status indicates success of the operation.

This method has id 3.11.

OcaStatus GetSinkConnector(OcaMediaConnectorID ID, OcaMediaSinkConnector &Connector)

Retrieves the descriptor of a given sink connector. Return status indicates the success of the operation.

This method has id 3.12.

OcaStatus GetConnectorsStatuses(OcaList<OcaMediaConnectorStatus> &Statuses)

Gets the status of all the source and sink connectors collected by this network object. Return status indicates success of the operation.

This method has id 3.13.

OcaStatus GetConnectorStatus(OcaMediaConnectorID ConnectorID, OcaMediaConnectorStatus &Status)

Gets the status of a single connector. Return status indicates success of the operation.

This method has id 3.14.

OcaStatus AddSourceConnector(OcaMediaSourceConnector Connector, OcaMediaConnectorState InitialStatus)

Adds a source connector to this network. Parameters of the new connector are given in the Connector parameter; device returns the same parameter with the new connector ID filled in. If the new connector’s AlignmentLevel property value is given as NaN, the value of this network’s AlignmentLevel property will be used. Return status indicates the success of the operation.

This method has id 3.15.

OcaStatus AddSinkConnector(OcaMediaConnectorStatus InitialStatus)

Adds a sinkconnector to this network. Parameters of the new connector are given in the Connector parameter; device returns the same parameter with the new connector ID filled in. If the new connector’s AlignmentLevel property value is given as NaN, the value of this network’s AlignmentLevel property will be used. If the new connector’s AlignmentGain property value is given as NaN, the value of this network’s AlignmentGain property will be used. Return status indicates the success of the operation.

This method has id 3.16.

OcaStatus ControlConnector(OcaMediaConnectorID ConnectorID, OcaMediaConnectorCommand Command)

Change the state of a given connector. Return status indicates the success of the operation.

This method has id 3.17.

OcaStatus SetSourceConnectorPinMap(OcaMediaConnectorID ConnectorID, OcaMap<OcaUint16, OcaPortID> ChannelPinMap)

Sets a source connector’s channel pin map. Return status indicates the success of the operation.

This method has id 3.18.

OcaStatus SetSinkConnectorPinMap(OcaMediaConnectorID ConnectorID, OcaMultiMap<OcaUint16, OcaPortID> ChannelPinMap)

Sets a sink connector’s channel pin map. Return status indicates the success of the operation.

This method has id 3.19.

OcaStatus SetConnectorConnection(OcaMediaConnectorID ConnectorID, OcaMediaConnection Connection)

Sets a connector’s Connection property. Return status indicates the success of the operation.

This method has id 3.20.

OcaStatus SetConnectorCoding(OcaMediaConnectorID ConnectorID, OcaMediaCoding Coding)

Sets the Coding field of the connection descriptor of the referenced connector. Return status indicates the success of the operation.

This method has id 3.21.

OcaStatus SetConnectorAlignmentLevel(OcaMediaConnectorID ConnectorID, OcaDBFS Level)

Sets the Alignment Level field of a connector. Value must be between the min and max values of the AlignmentLevel property of this network. A value of NaN will cause the current value of this network’s AlignmentLevel property to be used. Return status indicates the success of the operation.

This method has id 3.22.

OcaStatus SetConnectorAlignmentGain(OcaMediaConnectorID ConnectorID, OcaDB Gain)

For OcaMediaSinkConnectors only (not source). Sets the Alignment Gain field of the connection descriptor of the referenced connector. Value must be between the min and max values of the AlignmentGain property of this network. A value of NaN will cause the current value of the network’s AlignmentGain property to be used. Return status indicates the success of the operation.

This method has id 3.23.

OcaStatus DeleteConnector(OcaMediaConnectorID ID)

Deletes a connector from this network. Return status indicates the success of the operation.

This method has id 3.24.

  • ID: Input parameter.

OcaStatus GetAlignmentLevel(OcaDBFS &Level, OcaDBFS &MinLevel, OcaDBFS &MaxLevel)

Gets the default, min, and max alignment levels for OcaMedia{Source|Sink}Connectors attached to this network. Return status indicates success of the operation.

This method has id 3.25.

OcaStatus GetAlignmentGain(OcaDB &Gain, OcaDB &minGain, OcaDB &maxGain)

Gets the default, min, and max alignment gains for OcaMediaSinkConnectors attached to this network. Return status indicates success of the operation.

This method has id 3.26.

Methods inherited from 1.4 OcaApplicationNetwork:

Events:

void ConnectorStatusChanged(OcaMediaConnectorStatusChangedEventData eventData)

Event indicating that the status of a source or sink connector has changed.

This event has id 3.3.

void SinkConnectorChanged(OcaMediaSinkConnectorChangedEventData eventData)

Event indicating that a media sink connector has changed. The change type indicates if the connector was added, deleted or changed.

This event has id 3.2.

void SourceConnectorChanged(OcaMediaSourceConnectorChangedEventData eventData)

Event indicating that a media source connector has changed. The change type indicates if the connector was added, deleted or changed.

This event has id 3.1.