Name

 
videoGetInfo --- Return information about video devices
 
 

Syntax

 #include <mme/mme_api.h>
 DWORD videoGetInfo(DWORD dwDeviceID, LPVIDEOINFO info)
 

Arguments

 
DWORD dwDeviceID
Identifies the video device to open. The dwDeviceID field value can be zero to one value fewer than the number of video capture devices installed. 
LPVIDEOINFO info
Specifies a pointer to a VIDEOINFO data structure which the driver will fill. Memory must be allocated with the mmeAllocMem function.  Applications must set the dwSize and dwVersionInfo fields before calling this function. The dwSize field should be set to sizeof(VIDEOINFO) and the dwVersionInfo field should be set to VIDEO_INFO_VERSION. 
 
 

Description

 
The videoGetInfo function returns information about the specified video device. 
 
If the dwVersionInfo field version is greater than the version supported by the driver, the driver may optionally set the dwVersionInfo field to the version that the driver supports and set the fields that the driver does not support to zero. If the dwVersionInfo field version is less than the version supported by the driver, the driver may optionally set the dwVersionInfo field to the version that the driver supports and use the dwSize field to determine which fields of the data structure to set.  Drivers are not required to support a version other than the one that they support. If the version does not match, the application will receive the error DV_ERR_PARAM1. 
 
 

Extensions

 
The videoGetInfo function is a Digital extension to the Microsoft multimedia API specification. 
 
 

Return Values

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

 
DV_ERR_NOTSUPPORTED@T{ The function is not supported. T} DV_ERR_PARAM1@T{ The information parameter is incorrect. It is possible that the pointer is NULL, the memory pointed to was not allocated with the mmeAllocMem function, the dwSize field is not set to a valid size, or the dwVersionInfo field is not set to a version that the driver recognizes.  T} DV_ERR_BADDEVICEID@T{ The specified device ID is out of range. T} DV_ERR_NOMEM@T{ Unable to allocate or lock memory. T} DV_ERR_FLAGS@T{ The dwFlags channel is not supported by the device.  T}

 
 
None.