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 to a capture window.

szName

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

wSize

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

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.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

Video Capture, Video Capture Macros, WM_CAP_DRIVER_GET_NAME