MCI_GETDEVCAPS命令
MCI_GETDEVCAPS命令會擷取裝置的靜態資訊。 所有裝置都會辨識此命令。 此命令可用的參數和旗標取決於選取的裝置。 資訊會在lpCapsParms所識別結構的dwReturn成員中傳回。
若要傳送此命令，請使用下列參數呼叫 mciSendCommand 函式。
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_GETDEVCAPS,
DWORD dwFlags,
(DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);
參數
-
wDeviceID
-
要接收命令訊息之 MCI 裝置的裝置識別碼。
-
dwFlags
-
MCI_NOTIFY、MCI_WAIT或數位視訊和 VCR 裝置MCI_TEST。 如需這些旗標的相關資訊，請參閱 Wait、Notify 和 Test Flags。
-
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
-
如果裝置具有 timecode 功能或此功能未知， dwReturn 成員會設定為 TRUE ;否則，它會設定為 FALSE。
-
MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS
-
dwReturn成員會設定為 (99) 的標記數目。
-
MCI_VCR_GETDEVCAPS_SEEK_ACCURACY
-
dwReturn成員會設定為裝置的搜尋精確度。
您可以在重迭裝置類型的dwItem成員中指定下列旗標MCI_GETDEVCAPS_PARMS：
-
MCI_OVLY_GETDEVCAPS_CAN_FREEZE
-
如果裝置可以凍結影像， dwReturn 成員就會設定為 TRUE ;否則，它會設定為 FALSE。
-
MCI_OVLY_GETDEVCAPS_CAN_STRETCH
-
如果裝置可以延展影像以填滿畫面， dwReturn 成員會設定為 TRUE ;否則，它會設定為 FALSE。
-
MCI_OVLY_GETDEVCAPS_MAX_WINDOWS
-
dwReturn成員會設定為裝置可以同時處理的視窗數目上限。
您可以在videodisc裝置類型的MCI_GETDEVCAPS_PARMS dwItem成員中指定下列旗標：
-
MCI_VD_GETDEVCAPS_CAN_REVERSE
-
如果視訊磁片播放程式可以反向播放， dwReturn 成員會設定為 TRUE ;否則，它會設定為 FALSE。 有些玩家可以反向播放 CLV 光碟以及 CAV 光碟。
-
MCI_VD_GETDEVCAPS_CAV
-
與其他專案結合時，指定傳回信息適用于 CAV 格式視訊磁片。 如果未插入 videodisc，這是預設值。
-
MCI_VD_GETDEVCAPS_CLV
-
與其他專案結合時，指定傳回信息適用于 CLV 格式視訊discs。
-
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 [僅限桌面應用程式] |
| 標頭 |
|