Specifies the window and the window characteristics for graphic devices. Graphic devices should create a default window when a device is opened but should not display it until they receive a command that causes data to be displayed. The window command is used to supply an application-created window to the device and to change the display characteristics of an application-supplied or default display window. If the application supplies the display window, it should be prepared to update an invalid rectangle on the window.
Support of this message by a device is optional. The parameters and flags for this message vary according to the selected device.
DWORD lParam1
The following flags apply to all devices supporting MCI_WINDOW:
MCI_NOTIFY | Specifies that MCI should post the MM_MCINOTIFY message when this command completes. The window to receive this message is specified in the dwCallback member of the structure identified by lpWindow. |
MCI_WAIT | Specifies that the operation should finish before MCI returns control to the application. |
DWORD lpWindow
Specifies a far pointer to a device specific structure. For a description of this parameter, see the lpWindow description included with the device extensions.
Animation Extensions
The following additional flags for lParam1 apply to animation devices supporting MCI_WINDOW:
MCI_ANIM_WINDOW_HWND | Indicates the handle of the window to use for the destination is included in the hWnd member of the structure identified by lpWindow. Set this to MCI_ANIM_WINDOW_DEFAULT to return to the default window. |
MCI_ANIM_WINDOW_STATE | Indicates the nCmdShow member of the MCI_ANIM_WINDOW_PARMS structure contains parameters 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_ANIM_WINDOW_TEXT | Indicates the lpstrText member of the MCI_ANIM_WINDOW_PARMS structure contains a pointer to a buffer containing the caption used for the window. |
Note that lParam2 specifies a far pointer to a MCI_ANIM_WINDOW_PARMS structure. (Devices with additional parameters might replace this structure with a device-specific structure.)
Video Overlay Extensions
The following additional flags for lParam1 apply to video overlay devices supporting MCI_WINDOW:
MCI_OVLY_WINDOW_HWND | Indicates the handle of the window used for the destination is included in the hWnd member of the MCI_OVLY_WINDOW_PARMS structure. Set this to MCI_OVLY_WINDOW_DEFAULT to return to the default window. |
MCI_OVLY_WINDOW_STATE | Indicates the nCmdShow member of the lParam2 structure contains parameters for setting the window state. This flag It is equivalent to calling showwindow with the state parameter. The constants are the same as those defined in WINDOWS.H (such as SW_HIDE, SW_MINIMIZE, or SW_SHOWNORMAL.) |
MCI_OVLY_WINDOW_TEXT | Indicates the lpstrText member of the MCI_OVLY_WINDOWS_PARMS structure contains a pointer to buffer containing the caption used for the window. |
Note that lParam2 specifies a far pointer to a MCI_OVLY_WINDOW_PARMS structure. (Devices with additional parameters might replace this structure with a device-specific structure.)