MCI_GETDEVCAPS 命令

  • 项目

MCI_GETDEVCAPS 命令检索有关设备的静态信息。 所有设备都识别此命令。 此命令可用的参数和标志取决于所选设备。 信息在 lpCapsParms 标识的结构的 dwReturn 成员中返回。

若要发送此命令，请使用以下参数调用 mciSendCommand 函数。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_GETDEVCAPS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);

parameters

wDeviceID

要接收命令消息的 MCI 设备的设备标识符。

dwFlags

MCI_TEST MCI_NOTIFY、MCI_WAIT或数字视频和 VCR 设备。 有关这些标志的信息，请参阅 等待、通知和测试标志。

lpCapsParms

指向 MCI_GETDEVCAPS_PARMS 结构的指针。

返回值

如果成功，则返回零，否则返回错误。

备注

以下其他标准和特定于命令的标志适用于支持MCI_GETDEVCAPS的所有设备：

MCI_GETDEVCAPS_COMPOUND_DEVICE

如果设备使用必须显式打开和关闭的数据存储，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE 。

MCI_GETDEVCAPS_DEVICE_TYPE

dwReturn 成员设置为 MCI 设备类型中列出的值之一。

MCI_GETDEVCAPS_HAS_AUDIO

如果设备具有音频输出，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE 。

MCI_GETDEVCAPS_HAS_VIDEO

如果设备具有视频输出，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE 。 例如，对于支持 videodisc 命令集的设备，成员设置为 TRUE 。

MCI_GETDEVCAPS_ITEM

指定 MCI_GETDEVCAPS_PARMS 结构的 dwItem 成员包含以下常量之一：

MCI_GETDEVCAPS_CAN_EJECT

如果设备可以弹出媒体，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_GETDEVCAPS_CAN_PLAY

如果设备可以播放媒体，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。 如果设备指定 TRUE，则表示设备支持 MCI_PAUSE 和 MCI_STOP 命令以及 MCI_PLAY 命令。

MCI_GETDEVCAPS_CAN_RECORD

如果设备支持录制，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。 如果设备指定 TRUE，则表示设备支持 MCI_PAUSE 和 MCI_STOP 命令以及 MCI_RECORD 命令。

MCI_GETDEVCAPS_CAN_SAVE

如果设备可以保存文件，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_GETDEVCAPS_USES_FILES

如果设备需要文件名，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE 。 只有复合设备使用文件。

可以在 digitalvideo 设备类型的 MCI_GETDEVCAPS_PARMS 的 dwItem 成员中指定以下标志：

MCI_DGV_GETDEVCAPS_CAN_FREEZE

如果设备可以冻结帧，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_DGV_GETDEVCAPS_CAN_LOCK

如果设备可以锁定， 则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_DGV_GETDEVCAPS_CAN_REVERSE

如果设备可以反向播放，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_DGV_GETDEVCAPS_CAN_STR_IN

如果设备可以拉伸输入，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_DGV_GETDEVCAPS_CAN_STRETCH

如果设备可以拉伸图像，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_DGV_GETDEVCAPS_CAN_TEST

如果设备可以执行测试，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_DGV_GETDEVCAPS_HAS_STILL

如果设备可以显示静止图像，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_DGV_GETDEVCAPS_MAX_WINDOWS

dwReturn 成员设置为设备可以同时处理的最大窗口数。

MCI_DGV_GETDEVCAPS_MAXIMUM_RATE

dwReturn 成员设置为设备的最大播放速率（以每秒帧数为单位）。

MCI_DGV_GETDEVCAPS_MINIMUM_RATE

dwReturn 成员设置为设备的最小播放速率（以每秒帧数为单位）。

MCI_DGV_GETDEVCAPS_PALETTES

如果设备可以返回调色板句柄，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

可以在 vcr 设备类型的 MCI_GETDEVCAPS_PARMS 的 dwItem 成员中指定以下标志：

MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE

dwReturn 成员设置为每秒的增量数。

MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH

如果设备能够检测媒体的长度，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_VCR_GETDEVCAPS_CAN_FREEZE

如果设备能够冻结输出图像，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES

如果设备能够监视源，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_VCR_GETDEVCAPS_CAN_PREROLL

如果设备能够预生成，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_VCR_GETDEVCAPS_CAN_PREVIEW

如果设备能够预览，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_VCR_GETDEVCAPS_CAN_REVERSE

如果设备能够反向播放，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_VCR_GETDEVCAPS_CAN_TEST

如果设备能够测试，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_VCR_GETDEVCAPS_HAS_CLOCK

如果设备支持外部时钟，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_VCR_GETDEVCAPS_HAS_TIMECODE

如果设备具有时间码功能或此功能未知，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS

dwReturn 成员设置为标记数 (99) 。

MCI_VCR_GETDEVCAPS_SEEK_ACCURACY

dwReturn 成员设置为设备的查找精度。

可以在覆盖设备类型的 MCI_GETDEVCAPS_PARMS 的 dwItem 成员中指定以下标志：

MCI_OVLY_GETDEVCAPS_CAN_FREEZE

如果设备可以冻结图像，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_OVLY_GETDEVCAPS_CAN_STRETCH

如果设备可以拉伸图像以填充帧，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。

MCI_OVLY_GETDEVCAPS_MAX_WINDOWS

dwReturn 成员设置为设备可以同时处理的最大窗口数。

可以在视频磁盘设备类型的 MCI_GETDEVCAPS_PARMS 的 dwItem 成员中指定以下标志：

MCI_VD_GETDEVCAPS_CAN_REVERSE

如果视频磁盘播放器可以反向播放，则 dwReturn 成员设置为 TRUE ;否则，它设置为 FALSE。 某些玩家可以反向播放 CLV 光盘以及 CAV 光盘。

MCI_VD_GETDEVCAPS_CAV

与其他项结合使用时，指定返回信息应用于 CAV 格式视频磁盘。 如果未插入视频磁盘，则这是默认值。

MCI_VD_GETDEVCAPS_CLV

与其他项结合使用时，指定返回信息适用于 CLV 格式视频磁盘。

MCI_VD_GETDEVCAPS_FAST_RATE

dwReturn 成员设置为每秒帧数的标准快速播放速率。

MCI_VD_GETDEVCAPS_NORMAL_RATE

dwReturn 成员设置为正常播放速率（以帧/秒为单位）。

MCI_VD_GETDEVCAPS_SLOW_RATE

dwReturn 成员设置为每秒帧数的标准慢速播放速率。

可以在 waveaudio 设备类型的 MCI_GETDEVCAPS_PARMS 的 dwItem 成员中指定以下标志：

MCI_WAVE_GETDEVCAPS_INPUT

dwReturn 成员设置为记录) 设备的波形输入 (总数。

MCI_WAVE_GETDEVCAPS_OUTPUT

dwReturn 成员设置为) 设备播放 (波形输出的总数。

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
标头
Mmsystem.h (包括 Windows.h)

另请参阅

Mci

MCI 命令