Digital Video Extensions

DWORD lParam1 The following additional flags apply to digital-video devices supporting MCI_WINDOW:

MCI_DGV_WINDOW_HWND

Indicates the handle of the window to use for the destination is included in the hWnd field of the data structure identified by lParam2. Set this to MCI_DGV_WINDOW_DEFAULT to return to the default window. The default window has no owner unless a parent window is specified in the MCI_OPEN message.

Two device instances can use the same window handle provided that each instance updates the video and image pixels in the window as if the other instance did not exist.

MCI_DGV_WINDOW_STATE

Indicates the nCmdShow field of the MCI_DGV_WINDOW_PARMS data structure contains a value for setting the window state. This flag is equivalent to calling ShowWindow with the state parameter. The constants are the same as those in WINDOWS.H (such as SW_HIDE, SW_MINIMIZE, or SW_SHOWNORMAL.)

MCI_DGV_WINDOW_TEXT

Indicates the lpstrText field of the MCI_DGV_WINDOW_PARMS data structure contains a pointer to a buffer containing the caption used for the window title bar. If this text contains imbedded blanks, the entire caption must be enclosed in quotation marks. The default caption for the default window is blank.

LPMCI_DGV_WINDOW_PARMS lParam2

Specifies a far pointer to a MCI_DGV_WINDOW_PARMS data structure.

Return Value

Returns zero if successful. Otherwise, it returns an MCI error code.

Comments

For digital-video devices, this message provides the device driver instance with a handle to a window used to display images or motion video. If a window command is not used, the default window created when the device driver instance was opened is used. The default window's style is defined (or defaulted) when the instance is opened. Initially, the window is invisible. An application can change windows at any time by using the window command. The default window is not destroyed until the device driver instance is closed, and it is possible to switch back to it. The default window continues to show and play video when it is iconic. If the default window is not visible, it will be made visible automatically whenever a play or monitor input command is used.