IBM Books

Image Extender、Audio Extender 和 Video Extender 管理和程序设计

DBaPlay


图象 音频 视频
  X  

在客户机上打开音频播放器,并播放音频剪辑。可将音频剪辑存储在音频列或外部文件中:

若音频存储在列中,则 Extender 创建一个临时文件, 并将对象的内容从该列复制到该文件中。若音频存储在外部文件中, 且不能使用环境变量中的值解析其相对文件名,或不能在客户机上存取该文件, 则 Extender 也可能会创建一个临时文件。该临时文件是在 DB2AUDIOTEMP 环境变量中指定的目录中创建的。然后, Extender 播放临时文件中的音频。

授权

若播放在列中的音频剪辑,则选择用户表上的权限。

库文件
OS/2 和 Windows AIX、HP-UX 和 Solaris
dmbaudio.lib libdmbaudio.a (AIX)

libdmbaudio.sl (HP-UX)

libdmbaudio.so (Solaris)

包含文件

dmbaudio.h

语法

播放存储在列中的音频

long DBaPlay(
      char *playerName,
      MMDB_PLAY_HANDLE,
      DB2Audio *audioHandle,
      waitFlag
      );

语法

播放存储为文件的音频

long DBaPlay(
      char *playerName,
     MMDB_PLAY_FILE,
      char *fileName,
      waitFlag
      );

参数

playerName(输入)
音频播放器的名称。若设置为 NULL,则使用 DB2AUDIOPLAYER 环境变量指定的缺省音频播放器。

MMDB_PLAY_HANDLE(输入)
指示将音频存储成 BLOB 的常量。

MMDB_PLAY_FILE(输入)
一个常量,它指示将音频存储成可从客户机存取的文件。

audioHandle(输入)
音频的句柄。播放在列中的音频剪辑时,必须传送此参数。如果音频句柄表示外部文件,则使用客户机环境变量 DB2VIDEOPATH 来解析文件位置。

fileName(输入)
包含音频的文件的名称。

waitFlag(输入)
一个常量,它指示程序在继续之前是否等待用户关闭播放器。MMDB_PLAY_WAIT 在应用程序所在的线程中运行播放器。MMDB_PLAY_NO_WAIT 在另一线程中运行播放器。

错误码

MMDB_SUCCESS
对 API 调用的处理成功完成。

MMDB_RC_NO_AUTH
调用者没有正确的存取权限。

MMDB_RC_NOT_CONNECTED
应用程序没有与数据库的有效连接。

播放 audioHandle 标识的音频。在应用程序所在的线程中运行缺省播放器:

#include <dmbaudio.h>
 
rc = DBaPlay(NULL, MMDB_PLAY_HANDLE,
       audioHandle, MMDB_PLAY_WAIT);


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]