Compaq Multimedia Services
for OpenVMS Alpha
Programmer's Guide

Contents

Preface
Preface	Preface
Chapter 1
1	Introduction to Multimedia Services for OpenVMS
1.1	What is Multimedia Services for OpenVMS?
1.2	Compaq Extensions to the Microsoft Multimedia Programming Interface
1.3	Microsoft Multimedia Services Not Implemented in This Release
1.4	Multimedia Hardware Support
1.5	Application Development Notes
1.5.1	Server Process
1.5.2	Multimedia Services Library
1.5.3	Header Files
1.5.4	Compiling and Linking Applications
1.5.5	Waveform Audio Device Restrictions
1.5.6	Video Capture and Playback Restrictions
1.5.7	Video Compression and Decompression Restrictions
1.5.8	Memory Optimizations --- Regions and Buffers
Chapter 2
2	General Services
2.1	Allocating Memory
2.1.1	Memory Allocation Overview
2.1.2	Memory Allocation Header Files
2.1.3	Memory Allocation Function Overview
2.1.4	Memory Allocation Function Descriptions
Command 1	mmeAllocBuffer
Command 2	mmeAllocBufferAndGetShminfo
Command 3	mmeAllocMem
Command 4	mmeFreeBuffer
Command 5	mmeFreeMem
2.2	Managing Callbacks
2.2.1	Callback Services Overview
2.2.2	Callback Services Header Files
2.2.3	Callback Function Overview
2.2.4	Callback Function Descriptions
Command 6	mmeCheckForCallbacks
Command 7	mmeProcessCallbacks
Command 8	mmeServerFileDescriptor
Command 9	mmeWaitForCallbacks
2.3	Representing Time
Chapter 3
3	Waveform Audio Services
3.1	Waveform Audio Services Overview
3.2	Using Waveform Audio Services
3.2.1	Querying Waveform Audio Devices
3.2.1.1	Getting the Number of Waveform Audio Devices
3.2.1.2	Getting the Capabilities of a Waveform Audio Device
3.2.1.3	Getting the Formats of a Waveform Audio Device
3.2.2	Opening and Closing a Waveform Audio Device
3.2.3	Sharing a Waveform Audio Device
3.2.4	Controlling Playback and Record Volume
3.2.5	Allocating and Preparing Waveform Audio Data Blocks
3.2.6	Managing Waveform Audio Data Blocks
3.2.7	Using Callback Functions to Process Driver Messages
3.2.8	Handling Errors
3.3	Playing Waveform Audio Data
3.3.1	Querying a Waveform Audio Output Device
3.3.2	Opening a Waveform Audio Output Device
3.3.3	Specifying Waveform Audio Data Output Format
3.3.4	Using Callback Functions to Manage Waveform Audio Playback
3.3.5	Modifying Waveform Audio Playback Volume
3.3.6	Writing Waveform Audio Data to a Waveform Audio Output Device
3.3.7	Getting the Current Playback Position
3.3.8	Stopping, Pausing, and Restarting Audio Playback
3.3.9	Closing a Waveform Audio Output Device
3.4	Recording Waveform Audio Data
3.4.1	Querying a Waveform Audio Input Device
3.4.2	Opening a Waveform Audio Input Device
3.4.3	Selecting a Waveform Audio Input Device
3.4.4	Specifying Waveform Audio Input Data Format
3.4.5	PCM Waveform Audio Data Formats
3.4.6	Using Callback Functions to Manage Waveform Audio Recording
3.4.7	Modifying Waveform Audio Record Volume
3.4.8	Reading Data from a Waveform Audio Input Device
3.4.9	Stopping Waveform Audio Recording
3.4.10	Closing a Waveform Audio Input Device
3.5	Waveform Audio Header Files
3.6	Waveform Audio Data Structures
3.6.1	PCMWAVEFORMAT Data Structure
3.6.2	WAVEFORMAT Data Structure
3.6.3	WAVEFORMATINFO Data Structure
3.6.4	WAVEHDR Data Structure
3.6.5	WAVEINCAPS Data Structure
3.6.6	WAVEOUTCAPS Data Structure
3.6.7	ACMFORMATDETAILS Data Structure
3.7	Waveform Audio Function Overview
3.8	Waveform Audio Function Descriptions
Command 10	waveInAddBuffer
Command 11	waveInClose
Command 12	waveInFormatDetails
Command 13	waveInGetDevCaps
Command 14	waveInGetDevCapsEx
Command 15	waveInGetErrorText
Command 16	waveInGetID
Command 17	waveInGetFormatInfo
Command 18	waveInGetNumDevs
Command 19	waveInGetPorts
Command 20	waveInGetPosition
Command 21	waveInGetVolume
Command 22	waveInOpen
Command 23	waveInReset
Command 24	waveInSelectPorts
Command 25	waveInSetVolume
Command 26	waveInStart
Command 27	waveInStop
Command 28	waveOutBreakLoop
Command 29	waveOutClose
Command 30	waveOutFormatDetails
Command 31	waveOutGetDevCaps
Command 32	waveOutGetDevCapsEx
Command 33	waveOutGetErrorText
Command 34	waveOutGetFormatInfo
Command 35	waveOutGetID
Command 36	waveOutGetNumDevs
Command 37	waveOutGetPorts
Command 38	waveOutGetPosition
Command 39	waveOutGetVolume
Command 40	waveOutOpen
Command 41	waveOutPause
Command 42	waveOutReset
Command 43	waveOutRestart
Command 44	waveOutSelectPorts
Command 45	waveOutSetVolume
Command 46	waveOutWrite
3.9	Waveform Audio Return Values