Name

 
videoGetChannelCaps --- Retrieve a description of the capabilities of a channel
 
 

Syntax

 #include <mme/mme_api.h>
 MMRESULT videoGetChannelCaps(HVIDEO hvideo,
                             LPCHANNEL_CAPS lpChannelCaps,
                             DWORD dwSize);
 

Arguments

 
HVIDEO hVideo
Specifies a handle to a video device channel.

 
LPCHANNEL_CAPS lpChannelCaps
Specifies a pointer to a CHANNEL_CAPS data structure. This data structure is filled with information about the capabilities of the video device channel. 

The CHANNEL_CAPS data structure must be allocated with the mmeAllocMem function before being passed to the videoGetChannelCaps function. 
 
 
 
 
See the mmeAllocMem(3mms) reference page for more information about allocating memory for data structures. 
 
 

 
DWORD dwSize
Specifies the size of the CHANNEL_CAPS data structure. 
 
 

Description

 
The videoGetChannelCaps function retrieves a description of the capabilities of a channel.  For example, capability information might include whether or not the channel can crop and scale images. 

Note that you must use the videoOpen function before calling the videoGetChannelCaps function.  You must open a channel before calling the videoGetChannelCaps function. 
 
 

Extensions

 
None.
 
 

Return Values

 
Returns DV_ERR_OK if the function is successful; otherwise, it returns one of the following error codes:
 
 

 
DV_ERR_INVALHANDLE@T{ The specified device handle is invalid. T} DV_ERR_NOTSUPPORTED@T{ The function is not supported. T}