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 [僅限桌面應用程式]

另請參閱

Mci

MCI 命令字串

提示