MCIWndOpen

  • Article

The MCIWndOpen macro opens an MCI device and associates it with an MCIWnd window. For MCI devices that use data files, this macro can also open a specified data file, name a new file to be created, or display a dialog box to let the user select a file to open. You can use this macro or explicitly send the MCIWNDM_OPEN message.

LONG MCIWndOpen(
  hwnd,   
  szFile, 
  wFlags  
);

Parameters

hwnd

Handle of the MCIWnd window.

szFile

Pointer to a null-terminated string identifying the filename or MCI Device Names to open. Specify -1 for this parameter to display the Open dialog box.

wFlags

Flags associated with the device or file to open. The MCIWNDOPENF_NEW flag specifies a new file is to be created with the name specified in szFile.

Return Values

Returns zero if successful or an error otherwise.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

MCIWNDM_OPEN