《Microsoft windows多媒体程序员参考手册》

1.1 多媒体扩展的特点1

1.2 多媒体扩展软件的命名约定1

1.2.1 函数名1

第一章 简介1

1.2.2 消息名2

1.2.3 参数名2

1.3 多媒体扩展软件的函数调用约定3

1.4 本参考手册的内容4

1.5 约定4

1.6 相关资料5

1.7 联机参考5

2.2 低层波形音频服务7

第二章 函数综述7

2.1 高层音频服务7

2.2.1 查询波形设备8

2.2.2 打开/关闭波形设备8

2.2.3 取得波形设备的设备ID9

2.2.4 播放波形数据9

2.2.5 录制波形数据9

2.2.6 取得波形设备的当前位置9

2.2.7 控制波形播放10

2.2.8 控制波形录制10

2.2.9 改变音高和播放速率10

2.3 低层MIDI音频服务11

2.2.10 改变播放音量11

2.2.11 处理波形错误11

2.3.1 查询MIDI设备12

2.3.2 打开/关闭MIDI设备12

2.3.3 取得MIDI设备的设备ID12

2.3.4 发送MIDI消息13

2.3.5 接收MIDI消息13

2.3.6 控制MIDI输入14

2.3.7 改变MIDI音量和预存合成音色14

2.3.8 处理MIDI错误14

2.4 辅助音频服务14

2.5.2 处理影片文件15

2.5.1 加载多媒体影片演播器15

2.5 多媒体影片播放服务15

2.5.3 取得影片信息16

2.5.4 影片播放16

2.5.5 控制播放窗口16

2.5.6 控制播放17

2.6 文件I/O服务17

2.6.1 执行基本文件I/O18

2.6.2 执行缓冲的文件I/O18

2.6.3 使用RIFF文件19

2.6.4 使用定制的I/O过程19

2.7 媒体控制接口服务19

2.7.2 对时间数据进行编码和译码的MCI宏20

2.7.1 与MCI设备通讯20

2.8 操纵杆服务21

2.9 计时器服务22

2.10 屏幕保护服务22

2.11 位图显示服务22

2.12 调试服务22

第三章 函数目录25

3.1 函数前缀25

3.2 函数说明25

auxGetNumDevs26

auxGetVolume26

auxGetDevCaps26

auxSetVolume27

DefScreenSaverProc28

DisplayDib29

joyGetDevCaps30

joyGetNumDevs31

joyGetPos31

joyGetthreshold32

joyReleaseCapture32

joySetCapture32

joySetThreshold33

MCI_MAKE_HMS34

MCI_HMS_SECOND34

MCI_HMS_MINUTE34

MCI_HMS_HOUR34

MCI_MAKE_MSF35

MCI_MAKE_TMSF35

MCI_MSF_FRAME36

MCI_MSF_MINUTE36

MCI_MSF_SECOND36

MCI_MAF_FRAME36

MCI_TMSF_MINUTE37

MCI_TMSF_SECOND37

MCI_TMSF_TRACK37

mciGetErrorString38

mciGetDeviceID38

mciExcute38

mciSendCommand39

mciSendString41

mciSetYieldProc43

MessageBeep43

midiAddBuffer44

midiInClose45

midiInGetDevCaps45

midiInGetErrorText46

midiInGetID46

midiInGetNumDevs46

midiInOpen47

midiInprepareHeader48

midiInstart49

midiInReset49

midiInStop50

midiInUnprepareHeader50

midiOutCacheDrumPatches51

midiOutCachePatches52

midiOutClose53

midiOutGetDevCaps54

midiOutGetErrorText54

midiOutGetID55

midiOutGetMunDevs55

midiOutGetVolume55

midiOutLongMsg56

midiOutOpen57

midiOutPrepareHeader58

midiOutReset59

midiOutSetVolume59

midiOutShortMsg60

midiOutUnprepareHeader60

mmioAdvance61

mmioAscend62

mmioClose63

mmioCreateChunk63

mmioDescend64

mmioFOURCC66

mmioGetInfo66

mmioFlush66

mmioInstallIOProc67

mmioOpen69

mmioRead71

mmioSeek72

mmioSendMessage72

mmioSetBuffer73

mmioSetInfo74

mmioStringToFOURCC74

mmioWrite74

mmpAnimate75

mmpClose76

mmpAnimStopped76

mmpAnimStatus76

mmpError77

mmpFieldLoaded78

mmpFreeFile78

mmpGetCurFrame79

mmpGetFileInfo79

mmpGetFrameHook79

mmpGetInfo79

mmpGetMovieInfo81

mmpGetMute81

mmpGetPaletteHandle81

mmpGetRepeat81

mmpGoToFrame82

mmpGetStage82

mmpGetTempo82

mmpLoadFile83

mmpOpen84

mmpSetDC84

mmpSetFrameHook85

mmpSetInfo86

mmpSetMute87

mmpSetRepeat87

mmpSetStage88

mmpStartAnimating89

mmpStopAnimating89

mmpSetTempo89

mmpUpdate90

mmsystemGetVersion90

OutputDebugStr90

sndPlaySound91

timeBeginPeriod92

timeEndPeriod92

timeGetDevCaps92

timeGetSystemTime93

timeGetTime93

timeKillEvent93

timeSetEvent94

waveInClose95

waveInAddBuffer95

waveInGetDevCaps96

waveInGetErrorText96

waveInGetID97

waveInGetNumDevs97

waveInGetPosition97

waveInOpen98

waveInprepareHeader100

waveInReset100

waveInStart101

waveInStop101

waveInUnprepareHeader101

waveOutClose102

waveOutBreakLoop102

waveOutGetDevCaps103

waveOutGetErrorText103

waveOutGetID104

waveOutGetNumDevs104

waveOutGetPitch104

waveOutGetPlaybackRate105

waveOutGetPosition106

waveOutGetVolume106

waveOutOpen107

waveOutPause109

waveOutPrepareHeader109

waveOutSetPitch110

waveReset110

waveOutRestart110

waveOutSetPlaybackRate111

waveOutSetVolume111

waveOutUnprepareHeader112

waveOutWrite113

第四章 消息综述115

4.1 关于多媒体扩展软件消息115

4.2 音频消息115

4.2.1 波形输出消息115

4.2.2 波形输入消息116

4.2.3 MIDI输出消息116

4.2.4 MIDI输入消息117

4.3 媒体控制接口消息118

4.3.1 系统命令消息118

4.3.2 必需命令消息118

4.3.3 基本命令消息119

4.3.4 扩展命令消息120

4.3.5 窗口通告消息121

4.4 操纵杆消息121

4.5 文件I/O消息122

4.6 影片演播器消息123

4.7 屏幕保护程序消息123

5.1 MCI命令消息的扩充125

5.2 消息前缀125

第五章 消息目录125

5.3 消息说明126

MCI_BREAK126

MCI_CLOSE127

MCI_COPY127

MCI_CUE128

MCI_CUT128

MCI_DELETE129

MCI_FREEZE130

MCI_GETDEVCAPS130

MCI_INFO134

MCI_LOAD135

MCI_OPEN136

MCI_PASTE139

MCI_PAUSE139

MCI_PLAY140

MCI_PUT141

MCI_RECORD143

MCI_RESUME144

MCI_SAVE144

MCI_SEEK145

MCI_SET146

MCI_SOUND151

MCI_STATUS151

MCI_STEP157

MCI_SYSINFO158

MCI_STOP158

MCI_UNFREEZE159

MCI_WHERE159

MCI_WINDOW161

MIM_CLOSE162

MIM_DATA162

MIM_ERROR163

MIM_LONGDATA163

MIM_LONGERROR163

MIM_OPEN164

MM_JOY1BUTTONDOWN164

MM_JOY1MOVE165

MM_JOY1BUTONUP165

MM_JOY1ZMOVE166

MM_JOY2BUTTONDOWN166

MM_JOY2BUTTONUP167

MM_JOY2MOVE167

MM_JOY2ZMOVE168

MM_MCINOTEY168

MM_MIM_CLOSE169

MM_MIM_DATA169

MM_MIM_ERROR170

MM_MIM_LONGDATA170

MM_MIM_LONGERROR170

MM_MOM_DONE171

MM_MOM_CLOSE171

MM_MIM_OPEN171

MM_MOM_OPEN172

MM_WIM_CLOSE172

MM_WIM_DATA172

MM_WIM_OPEN172

MM_WOM_CLOSE173

MM_WOM_DONE173

MM_WOM_OPEN173

MMIOM_CLOSE174

MMIOM_OPEN174

MMIOM_READ174

MMIOM_WRITEFLUSH175

MMIOM_SEEK175

MMIOM_WRITE175

MMP_HOOK_FRAME176

MMP_HOOK_SCRIPT176

MOM_CLOSE176

MOM_DONE177

MOM_OPEN177

WIM_CLOSE177

WIM_DATA177

WIM_OPEN178

WM_SYSCOMMAND178

WOM_OPEN179

WOM_CLOSE179

WOM_DONE179

第六章 数据类型和结构181

6.1 数据类型181

6.2 数据结构综述182

6.2.1 辅助音频数据结构182

6.2.2 操纵杆数据结构182

6.2.3 媒体控制接口(MCI)数据结构182

6.2.4 MIDI音频数据结构185

6.2.5 影片播放数据结构185

6.2.6 多媒体文件I/O数据结构185

6.2.7 计时器数据结构185

6.3 数据结构参考186

6.2.8 波形音频数据结构186

第七章 MCI命令字符串225

7.1 关于MCI命令225

7.1.1 系统命令225

7.1.2 必需命令225

7.1.3 基本命令226

7.1.4 扩充命令226

7.1.5 建立命令字符串226

7.1.6 关于MCI设备类型227

7.2 使用MCI命令字符串228

7.2.1 打开一个设备228

7.2.2 关闭设备230

7.2.3 MCI命令的捷径和变化231

7.2.4 使用Notify和Wait标志231

7.2.5 从MCI设备中获得信息233

7.2.6 Play命令233

7.2.7 Stop、Pause和Resume命令233

7.3 对命令字符串进行试验233

7.3.1 MCITEST例子234

7.4 MCI系统命令235

7.5 用于所有设备的必需命令236

7.6 用于特定设备类型的基本命令237

7.7 动画和影片演播器命令238

7.8 CD音频(Redbook)命令243

7.9 MIDI音序器命令246

7.10 视盘播放器命令250

7.11 视频叠加命令253

7.12 波形音频命令257

第八章 多媒体文件格式263

8.1 关于RIFF标记文件格式263

8.1.1 块(chunk)263

8.1.2 RIFF范式264

8.1.3 定义和注册RIFF范式265

8.2 表示RIFF文件的方法266

8.2.1 元素表示法约定266

8.2.2 RIFF文件的基本表示法266

8.2.4 表示RIFF范式定义的扩充表示法268

8.2.3 用于四字符代码和字符串块的转义序列268

8.2.5 原子标号271

8.2.6 一个样本RIFF范式定义和RIFF范式271

8.3 在范式块中存储字符串273

8.3.1 NULL结尾字符串(ZSTR)格式273

8.3.2 字符串表格式273

8.3.3 NULL结尾的字节大小前缀字符(BZSTR)序列273

8.3.4 多行字符串格式273

8.3.5 选择一种存储方法273

8.4 LIST块274

8.5 INFO表块274

8.6 独立于设备的位图(DIB)文件格式275

8.6.1 DIB结构概述276

8.6.2 位图文件首部276

8.6.3 位图信息首部276

8.6.4 位图颜色表279

8.6.5 位图数据281

8.6.6 DIB文件的例子281

8.7 Windows 3.0位图压缩格式283

8.7.1 每像素8位的DIB压缩283

8.7.2 每像素4位的DIB压缩284

8.8 RIFF DIB文件格式(RDm)285

8.11.1 影片文件结构286

8.11 多媒体影片文件格式(RMMP)286

8.9 乐器数字接口(MIII)文件格式286

8.10 RIFF MIDI(RMID)文件格式286

8.11.2 影片文件数据块小结287

8.11.3 所选影片文件数据块的结构288

8.12 调色板文件格式(PAL)291

8.13 Rich文本格式(RTF)292

8.14 波形音频文件格式(WAVE)292

8.14.1 WAVE的范式定义293

8.14.2 WAVE块说明293

8.14.3 WAVE格式种类294

8.14.4 样本的数据格式296

8.14.5 WAVE文件的例子296

A.1 命令表297

附录A MCI命令字符串句法总结297

A.2 MCI系统命令集298

A.3 必需命令集299

A.4 基本命令集299

A.5 动画和影片播放器命令集301

A.6 CD音频命令集304

A.7 MIDI音序器命令集305

A.8 视盘命令集308

A.9 视频叠加命令集310

A.10 波形音频命令集313

附录B 厂家ID与产品ID一览表317

B.1 多媒体扩展软件的厂家D317

B.2 多媒体扩展软件的产品ID317