capability 命令
功能命令會要求裝置特定功能的相關資訊。 所有 MCI 裝置都會辨識此命令。
若要傳送此命令，請使用lpszCommand參數集呼叫mciSendString函式，如下所示。
_stprintf_s(
lpszCommand,
TEXT("capability %s %s %s"),
lpszDeviceID,
lpszRequest,
lpszFlags
);
參數
-
lpszDeviceID
-
MCI 裝置的識別碼。 開啟裝置時，會指派此識別碼或別名。
-
lpszRequest
-
識別裝置功能的旗標。 下表列出可辨識 功能 命令的裝置類型，以及每種類型所使用的旗標：
值 類型 類型 cdaudio - 可以退出
- 可以播放
- can record
- 可以儲存
- 複合裝置
- 裝置類型
- 有音訊
- 有影片
- 使用檔案
digitalvideo - 可以退出
- 可以凍結
- 可以鎖定
- 可以播放
- can record
- 可以反轉
- 可以儲存
- 可以伸展
- 可以延展輸入
- 可以測試
- 複合裝置
- 裝置類型
- 有音訊
- 仍然有
- 有影片
- 最大播放率
- 最低播放率
- 使用檔案
- 使用調色盤
- windows
overlay - 可以退出
- 可以凍結
- 可以播放
- can record
- 可以儲存
- 可以伸展
- 複合裝置
- 裝置類型
- 有音訊
- 有影片
- 使用檔案
- windows
排序器 - 可以退出
- 可以播放
- can record
- 可以儲存
- 複合裝置
- 裝置類型
- 有音訊
- 有影片
- 使用檔案
錄影機 - 可以偵測長度
- 可以退出
- 可以凍結
- 可以監視來源
- 可以播放
- 可以預先註冊
- 可以預覽
- can record
- 可以反轉
- 可以儲存
- 可以測試
- 時鐘遞增速率
- 複合裝置
- 裝置類型
- 有音訊
- 有時鐘
- 具有 timecode
- 有影片
- 標記數目
- 搜尋精確度
- 使用檔案
videodisc - 可以退出
- 可以播放
- can record
- 可以反轉
- 可以儲存
- CAV
- CLV
- 複合裝置
- 裝置類型
- 快速播放率
- 有音訊
- 有影片
- 正常播放率
- 慢速播放率
- 使用檔案
waveaudio - 可以退出
- 可以播放
- can record
- 可以儲存
- 複合裝置
- 裝置類型
- 有音訊
- 有影片
- 輸入
- 輸出
- 使用檔案
下表列出可在 lpszRequest 參數及其意義中指定的旗標：
Flags 意義 可以偵測長度 如果裝置可以偵測媒體的長度，則會傳回 TRUE 。 可以退出 如果裝置可以退出媒體，則會傳回 TRUE 。 可以凍結 如果裝置可以凍結畫面緩衝區中的資料，則會傳回 TRUE 。 可以鎖定 如果裝置可以鎖定資料，則傳回 TRUE 。 可以監視來源 如果裝置可以將輸入 (來源) 傳遞給受監視的輸出，則傳回 TRUE ，與目前的輸入選取範圍無關。 可以播放 如果裝置可以播放，則會傳回 TRUE 。 可以預先註冊 如果裝置支援具有提示命令的「預先註冊」旗標，則會傳回TRUE。 可以預覽 如果裝置支援預覽，則會傳回 TRUE 。 can record 如果裝置支援錄製，則傳回 TRUE 。 可以反轉 如果裝置可以反向播放，則會傳回 TRUE 。 可以儲存 如果裝置可以儲存資料，則會傳回 TRUE 。 可以伸展 如果裝置可以延展框架以填滿指定的顯示矩形，則會傳回 TRUE 。 可以延展輸入 如果裝置可以在將影像數位板化至畫面緩衝區的過程中調整大小，則會傳回 TRUE 。 可以測試 如果裝置辨識 test 關鍵字，則會傳回 TRUE 。 cav 與其他專案結合時，此旗標會指定傳回信息適用于 CAV 格式視訊discs。 如果未插入 videodisc，這是預設值。 時鐘遞增速率 傳回每秒支援之外部時鐘支援的細分數目。 如果外部時鐘是毫秒時鐘，傳回值為 1000。 如果傳回值為 0，則不支援任何時鐘。 clv 與其他專案結合時，此旗標會指定傳回信息適用于 CLV 格式視訊discs。 複合裝置 如果裝置支援 (檔案名) ，則會傳回 TRUE 。 裝置類型 傳回裝置類型名稱，可以是下列其中一項： - cdaudio
- dat
- digitalvideo
- 其他
- overlay
- 掃描器
- 排序器
- 錄影機
- videodisc
- waveaudio
快速播放率 傳回每秒畫面格中的快速播放速率，如果裝置無法快速播放，則傳回零。 有音訊 如果裝置支援音訊播放，則會傳回 TRUE 。 有時鐘 如果裝置有時鐘，則會傳回 TRUE 。 仍然有 如果裝置處理單一影像比動作視訊檔案更有效率的檔案，則會傳回 TRUE 。 具有 timecode 如果裝置能夠支援 timecode，則傳回 TRUE ;如果裝置未知，則傳回 TRUE。 有影片 如果裝置支援視訊，則傳回 TRUE 。 輸入 傳回輸入裝置總數。 最大播放率 傳回裝置每秒畫面格的最大播放速率。 最低播放率 傳回裝置每秒畫面格的最小播放率。 正常播放率 傳回裝置每秒畫面格的正常播放率。 標記數目 傳回可以使用的最大標記數目;零表示不支援標記。 輸出 傳回輸出裝置的總數。 搜尋精確度 傳回畫面格中搜尋的預期精確度;0 表示裝置畫面正確，1 表示裝置預期位於所指定搜尋位置的一個畫面格內，依此類錯。 慢速播放率 傳回每秒畫面格中的慢速播放速率，如果裝置無法緩慢播放，則傳回零。 使用檔案 如果複合裝置所使用的資料儲存體是檔案，則會傳回 TRUE 。 使用調色盤 如果裝置使用調色盤，則會傳回 TRUE 。 windows 傳回裝置可支援的同時顯示視窗數目。 -
lpszFlags
-
可以是 「wait」、「notify」 或兩者。 針對數位視訊和 VCR 裝置，也可以指定「測試」。 如需這些旗標的詳細資訊，請參閱 等候、通知和測試旗標。
傳回值
傳回mciSendString函式之lpszReturnString參數中的資訊。 此資訊相依于要求類型。
範例
下列命令會傳回 「mysound」 裝置的裝置類型。
capability mysound device type
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |