capCreateCaptureWindowA function (vfw.h)

The capCreateCaptureWindow function creates a capture window.

Syntax

HWND VFWAPI capCreateCaptureWindowA(
  LPCSTR lpszWindowName,
  DWORD  dwStyle,
  int    x,
  int    y,
  int    nWidth,
  int    nHeight,
  HWND   hwndParent,
  int    nID
);

Parameters

lpszWindowName

Null-terminated string containing the name used for the capture window.

dwStyle

Window styles used for the capture window. Window styles are described with the CreateWindowEx function.

x

The x-coordinate of the upper left corner of the capture window.

y

The y-coordinate of the upper left corner of the capture window.

nWidth

Width of the capture window.

nHeight

Height of the capture window.

hwndParent

Handle to the parent window.

nID

Window identifier.

Return value

Returns a handle of the capture window if successful or NULL otherwise.

Remarks

Note

The vfw.h header defines capCreateCaptureWindow as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header vfw.h
Library Vfw32.lib
DLL Avicap32.dll

See also

Creating a Capture Window

Video Capture

Video Capture Functions