MCI_CLOSE

The MCI_CLOSE command releases access to a device or file. All devices recognize this command.

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_CLOSE, 
    DWORD dwFlags, (DWORD) (LPMCI_GENERIC_PARMS) lpClose);
 

Parameters

wDeviceID

Device identifier of the MCI device that is to receive the command message.

dwFlags

MCI_NOTIFY or MCI_WAIT. For information about these flags, see The Wait, Notify, and Test Flags.

lpClose

Address of an MCI_GENERIC_PARMS structure. (You can also use an MCI_CLOSE_PARMS structure. For more information, see the comments for MCI_GENERIC_PARMS.)

Return Values

Returns zero if successful or an error otherwise.

Remarks

Exiting an application without closing any MCI devices it has opened can leave the device inaccessible. Your application should explicitly close each device or file when it is finished with it. MCI unloads the device when all instances of the device or all associated files are closed.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mmsystem.h.

See Also

MCI Overview, MCI Commands, MCI_GENERIC_PARMS