MCI_DGV_RESTORE_PARMSA structure (digitalv.h)

The MCI_DGV_RESTORE_PARMS structure contains information for the MCI_RESTORE command for digital-video devices.

Syntax

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

Members

dwCallback

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

lpstrFileName

Pointer to a null-terminated string containing the filename from which the frame buffer information will be restored.

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_RESTORE_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

MCI_RESTORE

RECT

mciSendCommand