capCreateCaptureWindowA function (vfw.h)

Article
02/22/2024

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