QM_SetChannelUsage

QM_SetChannelUsage(areaRef; channelRef; channelUsage):error
	areaRef	Longint	Grabber area reference
	channelRef	Longint	Channel reference
	channelUsage	Longint	Channel usage
	error	Longint	Error result

Changes the channel's usage in the grabber plug-in area. A channel can be used in preview, in recording, and it can play during record or not.

The grabber plug-in area is specified by areaRef.

Parameter channelRef is the reference to the channel. The channel reference must have been previously obtained with a call to QM_NewChannel.

Parameter channelUsage specifies the channel's usage in the grabber plug-in area. The channelUsage parameter can be constructed by combining (with addition or bitwise "or") any of the following constants.

qm_seqGrabRecord	1	Channel is used in recording.
qm_seqGrabPreview	2	Channel is used in preview.
qm_seqGrabPlayDuringRecord	4	Channel plays during record.

Example

C_LONGINT($channelUsage)

$channelUsage:=qm_seqGrabRecord | qm_seqGrabPreview

$error:=QM_SetChannelUsage(xGrabber;$videoChannel;$channelUsage)

Related commands

QM_GetChannelUsage

Returns the channel's usage.