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 [仅限桌面应用] |
| 标头 |
|