Basic Command Messages

Basic commands are commands all device types should understand but can modify the parameters. For example, when issuing a PLAY command to a Videodisc Player, it might be desirable to indicate the speed of playback in frames per second. However, a device such as a CD Player might not have the capability to play back at different speeds.

The list of basic commands is shown in the following table. If a device does not use a device-type command, it can return MCIERR_UNSUPPORTED_FUNCTION. If a device supports the command, but not all of the options, it can return the MCIERR_UNSUPPORTED_FLAG for options that are not applicable.

кФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
ГMessage                 ГDescription                             Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_CONNECTOR           ГEnables, disables, counts the number of,Г
Г                        Гor queries the status of connectors.    Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_LOAD                ГLoads a new device element (file name)  Г
Г                        Гinto an open device context.            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_MASTERAUDIO         ГSets the system master audio setting forГ
Г                        Гall audio devices in the system.        Г
Г                        ГMCI_MASTERAUDIO is also used as a systemГ
Г                        Гcommand to query the current audio      Г
Г                        Гsettings when the driver is first       Г
Г                        Гopened.                                 Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_PAUSE               ГSuspends device playback.               Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_PLAY                ГStarts playing the device.              Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_RECORD              ГStarts recording data.                  Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_RESUME              ГResumes playing or recording from a     Г
Г                        Гpaused state.                           Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SAVE                ГSaves data for the device.              Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SEEK                ГMoves to the specified position and     Г
Г                        Гstops.                                  Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SET                 ГSets the operating state of the device. Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SETCUEPOINT         ГSets a cuepoint.                        Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SETPOSITIONADVISE   ГSets a position change notification for Г
Г                        Гthe device.                             Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_STATUS              ГObtains information about the status of Г
Г                        Гa media device.                         Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_STOP                ГStops the device.                       Г
РФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

The basic command messages use the ulParam1 parameter for the flags applicable to the command message. They also use the pParam2 parameter for a pointer to a message-specific data structure. Your MCD might add flags and parameters to create extended commands. When you extend a command message, your MCD must still respond to the basic flags and parameters.

The following table identifies the flags and data structures of the basic command messages. For a complete reference of media control interface commands, refer to the OS/2 Multimedia Programming Reference.

кФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
ГMessage                 ГParameters (ulParam1)       ГData Structure (pParam2)    Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_CONNECTOR           ГMCI_NOTIFY                  ГMCI_CONNECTOR_PARMS         Г
Г                        ГMCI_WAIT                    Г                            Г
Г                        ГMCI_ENABLE_CONNECTOR        Г                            Г
Г                        ГMCI_DISABLE_CONNECTOR       Г                            Г
Г                        ГMCI_QUERY_CONNECTOR_STATUS  Г                            Г
Г                        ГMCI_CONNECTOR_TYPE          Г                            Г
Г                        ГMCI_CONNECTOR_INDEX         Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_LOAD                ГMCI_OPEN_ELEMENT            ГMCI_LOAD_PARMS              Г
Г                        ГMCI_OPEN_MMIO               Г                            Г
Г                        ГMCI_NOTIFY                  Г                            Г
Г                        ГMCI_WAIT                    Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_MASTERAUDIO         ГMCI_WAIT                    ГMCI_MASTERAUDIO_PARMS       Г
Г                        ГMCI_QUERYCURRENTSETTING     Г                            Г
Г                        ГMCI_QUERYSAVEDSETTING       Г                            Г
Г                        ГMCI_SAVESETTING             Г                            Г
Г                        ГMCI_MASTERVOL               Г                            Г
Г                        ГMCI_SPEAKERS                Г                            Г
Г                        ГMCI_HEADPHONES              Г                            Г
Г                        ГMCI_ON                      Г                            Г
Г                        ГMCI_OFF                     Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_PAUSE               ГMCI_NOTIFY                  ГMCI_GENERIC_PARMS           Г
Г                        ГMCI_WAIT                    Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_PLAY                ГMCI_NOTIFY                  ГMCI_PLAY_PARMS              Г
Г                        ГMCI_WAIT                    Г                            Г
Г                        ГMCI_FROM                    Г                            Г
Г                        ГMCI_TO                      Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_RECORD              ГMCI_NOTIFY                  ГMCI_RECORD_PARMS            Г
Г                        ГMCI_WAIT                    Г                            Г
Г                        ГMCI_FROM                    Г                            Г
Г                        ГMCI_TO                      Г                            Г
Г                        ГMCI_RECORD_INSERT           Г                            Г
Г                        ГMCI_RECORD_OVERWRITE        Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_RESUME              ГMCI_NOTIFY                  ГMCI_GENERIC_PARMS           Г
Г                        ГMCI_WAIT                    Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SAVE                ГMCI_NOTIFY                  ГMCI_SAVE_PARMS              Г
Г                        ГMCI_WAIT                    Г                            Г
Г                        ГMCI_SAVE_FILE               Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SEEK                ГMCI_NOTIFY                  ГMCI_SEEK_PARMS              Г
Г                        ГMCI_WAIT                    Г                            Г
Г                        ГMCI_TO                      Г                            Г
Г                        ГMCI_TO_START                Г                            Г
Г                        ГMCI_TO_END                  Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SET                 ГMCI_NOTIFY                  ГMCI_SET_PARMS               Г
Г                        ГMCI_WAIT                    Г                            Г
Г                        ГMCI_SET_AUDIO               Г                            Г
Г                        ГMCI_SET_DOOR_OPEN           Г                            Г
Г                        ГMCI_SET_DOOR_CLOSED         Г                            Г
Г                        ГMCI_SET_DOOR_LOCK           Г                            Г
Г                        ГMCI_SET_DOOR_UNLOCK         Г                            Г
Г                        ГMCI_SET_VOLUME              Г                            Г
Г                        ГMCI_OVER                    Г                            Г
Г                        ГMCI_SET_VIDEO               Г                            Г
Г                        ГMCI_SET_ON                  Г                            Г
Г                        ГMCI_SET_OFF                 Г                            Г
Г                        ГMCI_SET_SPEED_FORMAT        Г                            Г
Г                        ГMCI_SET_TIME_FORMAT         Г                            Г
Г                        ГMCI_SET_ITEM                Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SETCUEPOINT         ГMCI_NOTIFY                  ГMCI_CUEPOINT_PARMS          Г
Г                        ГMCI_WAIT                    Г                            Г
Г                        ГMCI_SET_CUEPOINT_ON         Г                            Г
Г                        ГMCI_SET_CUEPOINT_OFF        Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_SETPOSITIONADVISE   ГMCI_NOTIFY                  ГMCI_POSITION_PARMS          Г
Г                        ГMCI_WAIT                    Г                            Г
Г                        ГMCI_SET_POSITION_ADVISE_ON  Г                            Г
Г                        ГMCI_SET_POSITION_ADVISE_OFF Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_STATUS              ГMCI_NOTIFY                  ГMCI_STATUS_PARMS            Г
Г                        ГMCI_WAIT                    Г                            Г
Г                        ГMCI_STATUS_START            Г                            Г
Г                        ГMCI_TRACK                   Г                            Г
Г                        ГMCI_STATUS_ITEM             Г                            Г
УФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
ГMCI_STOP                ГMCI_NOTIFY                  ГMCI_GENERIC_PARMS           Г
Г                        ГMCI_WAIT                    Г                            Г
РФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

[Back] [Next]