MCIWndCreate
The MCIWndCreate
function registers the MCIWnd window class and creates an MCIWnd window for
using MCI services. MCIWndCreate can also open an MCI device or file
(such as an AVI file) and associate it with the MCIWnd window.
HWND MCIWndCreate(
|
HWND hwndParent, |
|
|
HINSTANCE hInstance, |
|
|
DWORD dwStyle, |
|
|
LPSTR szFile |
|
|
); |
|
Parameters
hwndParent
Handle of the
parent window.
hInstance
Handle of the
module instance to associate with the MCIWnd window.
dwStyle
Flags
defining the window style. In addition to specifying the window styles used
with the CreateWindowEx
function, you can specify the following styles to use with MCIWnd windows:
MCIWNDF_NOAUTOSIZEWINDOW
Will not
change the dimensions of an MCIWnd window when the image size changes.
MCIWNDF_NOAUTOSIZEMOVIE
Will not
change the dimensions of the destination rectangle when an MCIWnd window size
changes.
MCIWNDF_NOERRORDLG
Inhibits
display of MCI errors to users.
MCIWNDF_NOMENU
Hides the
Menu button from view on the toolbar and prohibits users from accessing its pop-up
menu.
MCIWNDF_NOOPEN
Hides the
open and close commands from the MCIWnd menu and prohibits users from accessing
these choices in the pop-up menu.
MCIWNDF_NOPLAYBAR
Hides the
toolbar from view and prohibits users from accessing it.
MCIWNDF_NOTIFYANSI
Causes MCIWnd
to use an ANSI string instead of a Unicode string when notifying the parent
window of device mode changes. This flag is used in combination with
MCIWNDF_NOTIFYMODE and is exclusive to Windows NT.
MCIWNDF_NOTIFYMODE
Causes MCIWnd
to notify the parent window with an MCIWNDM_NOTIFYMODE message whenever the device
changes operating modes. The lParam parameter of this message identifies
the new mode, such as MCI_MODE_STOP.
MCIWNDF_NOTIFYPOS
Causes MCIWnd
to notify the parent window with an MCIWNDM_NOTIFYPOS message whenever a change in
the playback or record position within the content occurs. The lParam
parameter of this message contains the new position in the content.
MCIWNDF_NOTIFYMEDIA
Causes MCIWnd
to notify the parent window with an MCIWNDM_NOTIFYMEDIA message whenever a new device
is used or a data file is opened or closed. The lParam parameter of this
message contains a pointer to the new filename.
MCIWNDF_NOTIFYSIZE
Causes MCIWnd
to notify the parent window when the MCIWnd window size changes.
MCIWNDF_NOTIFYERROR
Causes MCIWnd
to notify the parent window when an MCI error occurs.
MCIWNDF_NOTIFYALL
Causes all
MCIWNDF window notification styles to be used.
MCIWNDF_RECORD
Adds a Record
button to the toolbar and adds a new file command to the menu if the MCI device
has recording capability.
MCIWNDF_SHOWALL
Causes all
MCIWNDF_SHOW styles to be used.
MCIWNDF_SHOWMODE
Displays the
current mode of the MCI device in the window title bar. For a list of device
modes, see the MCIWndGetMode
macro.
MCIWNDF_SHOWNAME
Displays the
name of the open MCI device or data file in the MCIWnd window title bar.
MCIWNDF_SHOWPOS
Displays the
current position within the content of the MCI device in the window title bar.
szFile
Null-terminated
string indicating the name of an MCI device or data file to open.
Return Values
Returns the
handle to an MCI window if successful or zero otherwise.
Remarks
Default
window styles for a child window are WS_CHILD, WS_BORDER, and WS_VISIBLE. MCIWndCreate
assumes a child window when a non-NULL handle of a parent window is specified.
Default
window styles for a parent window are WS_OVERLAPPEDWINDOW and WS_VISIBLE. MCIWndCreate
assumes a parent window when a NULL handle of a parent window is specified.
Use the window
handle returned by this function for the window handle in the MCIWnd macros. If
your application uses this function, it does not need to use the MCIWndRegisterClass
function.
See Also