capGetDriverDescription

The capGetDriverDescription function retrieves the version description of the capture driver.

BOOL VFWAPI capGetDriverDescription(
  WORD wDriverIndex,  
  LPSTR lpszName,     
  INT cbName,         
  LPSTR lpszVer,      
  INT cbVer           
);
 

Parameters

wDriverIndex

Index of the capture driver. The index can range from 0 through 9.

Plug-and-Play capture drivers are enumerated first, followed by capture drivers listed in the registry, which are then followed by capture drivers listed in SYSTEM.INI.

lpszName

Address of a buffer containing a null-terminated string corresponding to the capture driver name.

cbName

Length, in bytes, of the buffer pointed to by lpszName.

lpszVer

Address of a buffer containing a null-terminated string corresponding to the description of the capture driver.

cbVer

Length, in bytes, of the buffer pointed to by lpszVer.

Return Values

Returns TRUE if successful or FALSE otherwise.

Remarks

If the information description is longer than its buffer, the description is truncated. The returned string is always null-terminated. If a buffer size is zero, its corresponding description is not copied.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.
  Import Library: Use vfw32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Video Capture Overview, Video Capture Functions