MCI_DEVICESETTINGS
This message is sent to a media control interface driver (MCD) when the Multimedia Setup application is inserting pages into a Settings notebook. This message provides the MCD the opportunity to insert custom settings pages.
Syntax
param1 ULONG ulParam1; /* Flags for device settings. */ param2 PMCI_DEVICESETTINGS_PARMS pParam2; /* Pointer to the MCI_DEVICESETTINGS_PARMS data structure. */
Parameters
- ulParam1 (ULONG) - input
- This parameter can contain any of the following flags:
- > **Note:** The **MCI_NOTIFY** flag is not valid for this message.
- MCI_WAIT Control is not to be returned until the action indicated by this message is completed or an error occurs.
- pParam2 (PMCI_DEVICESETTINGS_PARMS) - input
- A pointer to the MCI_DEVICESETTINGS_PARMS data structure.
Returns
- hwnd (HWND) - returns
- Returns the handle to a settings page or zero if no page is inserted.
Remarks
This message is sent only if the **MCI_SYSINFO_DEVICESETTINGS** flag is set in the ulDeviceFlag field of the MCI_SYSINFO_LOGDEVICE data structure. Refer to the OS/2 Multimedia Subsystem Programming Guide for details of inserting settings pages.
This command does not require the device to be opened.
> **Note:** This command is used mainly by the Multimedia Setup application and should not be used by general purpose OS/2 multimedia applications.
Example Code
ULONG mciDriverEntry (PINSTANCE pInst,
USHORT usMessage,
ULONG ulParam1,
ULONG ulParam2,
USHORT usUserParam)
{
switch (usMessage) {
case MCI_DEVICESETTINGS:
return(InsertPage ((PMCI_DEVICE_SETTINGS_PARMS) ulParam2));
}
}