capDriverGetName

The capDriverGetName macro returns the name of the capture driver connected to the capture window. You can use this macro or explicitly call the WM_CAP_DRIVER_GET_NAME message.

BOOL capDriverGetName(
  hwnd,    
  szName,  
  wSize    
);
 

Parameters

hwnd

Handle of a capture window.

wSize

Size, in bytes, of the buffer referenced by szName.

szName

Address of an application-defined buffer used to return the device name as a null-terminated string.

Return Values

Returns TRUE if successful or FALSE if the capture window is not connected to a capture driver.

Remarks

The name is a text string retrieved from the driver's resource area. Applications should allocate approximately 80 bytes for this string. If the driver does not contain a name resource, the full path name of the driver listed in the registry or in the SYSTEM.INI file is returned.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.

See Also

Video Capture Overview, Video Capture Macros, WM_CAP_DRIVER_GET_NAME