h324VideoTemporalSpatialTradeoff

Sends a VideoTemporalSpatialTradeoff message to the remote terminal.

Prototype

DWORD h324VideoTemporalSpatialTradeoff ( MSPHD msphd, unsigned short tradeoff)

Argument	Description
msphd	MSPP handle associated with the MUX endpoint.
tradeoff	Temporal-spatial tradeoff value between 0 and 31 (unsigned integer).

Return values

Return value	Description
SUCCESS
CTAERR_NOT_FOUND	msphd was not found. Either h324Start was not called or h324Delete was called.
H324ERR_INTERNAL_ERROR	Internal error in the H.324M Middleware.
H324ERR_MUTEX_LOCK_FAILED	Internal error trying to lock mutex.
H324ERR_NOT_INITIALIZED	h324Initialize was not called first.

Events

None.

Details

A tradeoff value of zero indicates a high spatial resolution. A tradeoff value of 31 indicates a high frame rate. msphd identifies the MUX endpoint and the logical channel number of the associated outbound video channel.

Per H.245, values from 0 to 31 indicate monotonically a higher frame rate, and actual values do not correspond to precise values of spatial resolution or frame rate.

Example

ret = h324VideoTemporalSpatialTradeoff(GwConfig[0].MuxEp.hd, tradeoff);
if (ret == SUCCESS)
    printf("The videoTemporalSpatialTradeoff Indication message was sent
            successfully.\n");
else
    printf("Failed to send the videoTemporalSpatialTradeoff Indication message...\n");