capDriverGetName macro

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.

Syntax


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 value

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Vfw.h

See also

Video Capture
Video Capture Macros

 

 

Show: