MMProgRef - Introduction

Reprint Courtesy of International Business Machines Corporation, © International Business Machines Corporation

Multimedia Programming Reference

Introduction What's New... MCI Functions High-Level Macro Service Functions Subsystem Messages Notification Messages MCI Command Messages String Commands Memory Playlist Commands Graphic Button Control Secondary Window Functions MMIO Functions MMIO Messages CODEC Messages DIVE Functions Real-Time MIDI Functions SPI Functions Data Stream State Table SMH Messages DDCMD Messages VSD Commands SHD Messages SHC Messages Data Types Types of MIDI Messages Multimedia Specification Overview Resource Interchange File Format Multimedia File Formats RIFF Compound Files and Elements - Sharing and Access Return Codes Notices Glossary

This reference is for application programmers interested in creating OS/2 multimedia applications. It is also for subsystem developers who are interested in writing and installing subsystems to support specific data or devices. The IBM Developer's Toolkit for OS/2 Warp includes the bindings, header files, and libraries for development of OS/2 multimedia applications. OS/2 multimedia was referred to as Multimedia Presentation Manager/2 or MMPM/2 in previous releases.

Software Motion Video

The interface definitions for the digital video recording device are also provided in this reference. The digital video device uses **software-only** compression algorithms (**software motion video**) to enable playing or recording video without any additional video compression or decompression hardware.

Header Files

OS/2 multimedia includes header files with naming conventions compatible with the standard OS/2 format. Applications using previous versions of the MMPM/2 header files will still use those header files by default when the applications are compiled. In order to use the OS/2-consistent header files in an application, define INCL_OS2MM in the program before including the OS/2 multimedia system header file OS2ME.H. Defining INCL_OS2MM automatically defines the following:

INCL_MCIOS2

MCI-related include files (**MCIOS2.H** and **MMDRVOS2.H**)

INCL_MMIOOS2

MMIO include file (**MMIOOS2.H**)

The following additional header files have naming conventions compatible with the standard OS/2 format:

• MIDIOS2.H
• CDAUDOS2.H

Additional Multimedia Information

Multimedia REXX

(online) Describes REXX functions that enable media control interface string commands to be sent from an OS/2 command file to control multimedia devices. This online book is provided with OS/2 multimedia.

Guide to Multimedia User Interface Design

(41G2922) Describes design concepts to be considered when designing a CUA multimedia interface that is consistent within a particular multimedia product and across other products.

Using This Online Book

Before you begin to use this online book, it would be helpful to understand how you can:

• Expand the Contents to see all available topics
• Obtain additional information for a highlighted word or phrase
• Use action bar choices.

How To Use the Contents

When the Contents window first appears, some topics have a plus (+) sign beside them. The plus sign indicates that additional topics are available. To expand the Contents if you are using a mouse, select the plus sign (+). If you are using a keyboard, use the Up or Down Arrow key to highlight the topic, and press the plus key (+). To view a topic, double-click on the topic (or press the Up or Down Arrow key to highlight the topic, and then press Enter).

How To Obtain Additional Information

After you select a topic, the information for that topic appears in a window. Highlighted words or phrases indicate that additional information is available. You will notice that certain words in the following paragraph are highlighted in green letters, or in white letters on a black background. These are called hypertext terms. If you are using a mouse, double-click on the highlighted word. If you are using a keyboard, press the Tab key to move to the highlighted word, and then press the Enter key. Additional information will appear in a window.

How To Use Action Bar Choices

Several choices are available for managing information presented in the M-Control Program/2 Programming Reference. There are three pull-down menus on the action bar: the **Services** menu, the **Options** menu, and the **Help** menu.

The actions that are selectable from the **Services** menu operate on the active window currently displayed on the screen. These actions include the following:

Bookmark

Sets a place holder so you can retrieve information of interest to you.

When you place a bookmark on a topic, it is added to a list of bookmarks you have previously set. You can view the list, and you can remove one or all bookmarks from the list. If you have not set any bookmarks, the list is empty.

To set a bookmark, do the following:

1. Select a topic from the Contents.
2. When that topic appears, choose the **Bookmark** option from the **Services** menu.
3. If you want to change the name used for the bookmark, type the new name in the field.
4. Select the **Place** radio button (or press the Up or Down Arrow key to select it).
5. Select **OK**. The bookmark is then added to the bookmark list.

Search

Finds occurrences of a word or phrase in the current topic, selected topics, or all topics. You can specify a word or phrase to be searched. You can also limit the search to a set of topics by first marking the topics in the Contents list.

To search for a word or phrase in all topics, do the following:

1. Choose the **Search** option from the **Services** pull-down.
2. Type the word or words to be searched.
3. Select **All sections**.
4. Select **Search** to begin the search.
5. The list of topics where the word or phrase appears is displayed.

Print

Prints one or more topics. You can also print a set of topics by first marking the topics in the Contents list.

You can print one or more topics. You can also print a set of topics by first marking the topics on the Contents list.

To print the document Contents list, do the following:

1. Select **Print** from the **Services** menu.
2. Select **Contents**.
3. Select **Print**.
4. The Contents list is printed on your printer.

Copy

Copies a topic you are viewing to a file you can edit. You can copy a topic you are viewing into a temporary file named **TEXT.TMP**. You can later edit that file by using an editor such as the System Editor.

To copy a topic, do the following:

1. Expand the Contents list and select a topic.
2. When the topic appears, select **Copy to file** from the **Services** menu.

The system copies the text pertaining to that topic into the temporary **TEXT.TMP** file.

For information on any of the other choices in the **Services** menu, highlight the choice and press the F1 key.

Options

Changes the way the Contents is displayed.

You can control the appearance of the Contents list.

To expand the Contents and show all levels for all topics, select **Expand all** from the **Options** menu.

For information on any of the other choices in the **Options** menu, highlight the choice and press the F1 key.