MCI_DGV_CAPTURE_PARMSA structure (digitalv.h)

  • Article

The MCI_DGV_CAPTURE_PARMS structure contains parameters for the MCI_CAPTURE command for digital-video devices.

Syntax

typedef struct {
  DWORD_PTR dwCallback;
  LPSTR     lpstrFileName;
  POINT     ptOffset;
  POINT     ptExtent;
  RECT      rc;
} MCI_DGV_CAPTURE_PARMSA;

Members

dwCallback

The low-order word specifies a window handle used for the MCI_NOTIFY flag.

lpstrFileName

Pointer to a null-terminated string specifying the destination path and filename for the file that receives the captured data.

ptOffset

ptExtent

rc

Rectangle containing positioning information. RECT structures are handled differently in MCI than in other parts of Windows; in MCI, rc.right contains the width of the rectangle and rc.bottom contains its height.

Remarks

When assigning data to the members of this structure, set the corresponding flags in the fdwCommand parameter of the mciSendCommand function to validate the members.

Note

The digitalv.h header defines MCI_DGV_CAPTURE_PARMS 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]
Header digitalv.h

See also

MCI

MCI Structures

RECT

mciSendCommand