MCI_LIST 命令
MCI_LIST命令會取得裝置可用輸入數目和類型的相關資訊。 數位視訊和 VCR 裝置可辨識此命令。
若要傳送此命令，請使用下列參數呼叫 mciSendCommand 函式。
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_LIST,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpList
);
參數
-
wDeviceID
-
要接收命令訊息之 MCI 裝置的裝置識別碼。
-
dwFlags
-
MCI_NOTIFY、MCI_WAIT或MCI_TEST。 如需這些旗標的相關資訊，請參閱 等候、通知和測試旗標 。
-
lpList
-
MCI_GENERIC_PARMS 結構的指標。 （具有擴充命令集的裝置可能會以裝置特定結構取代這個結構。
傳回值
如果成功或發生錯誤，則傳回零。
備註
下列其他旗標適用于 digitalvideo 裝置類型：
-
MCI_DGV_LIST_ALG
-
lpList 所 識別之結構的 lpstrAlgorithm 成員包含包含演算法名稱之緩衝區的位址。 此名稱用來擷取與演算法相關聯的品質描述元類型。
-
MCI_DGV_LIST_COUNT
-
傳回指定型別的選項數目。
-
MCI_DGV_LIST_ITEM
-
常數，表示清單類型包含在 lpList 所 識別結構的 dwItem 成員中。 需要此旗標。 使用下列其中一個常數來指出清單類型：
-
MCI_DGV_LIST_AUDIO_ALG
-
命令應該擷取音訊演算法的名稱。
-
MCI_DGV_LIST_AUDIO_QUALITY
-
命令應該會擷取音訊品質等級。 傳回的層級會與 lpList 所識別 之結構的 lpstrAlgorithm 成員所參考 的演算法相關聯。 如果使用字串 「current」 指定該成員，則會傳回與目前演算法相關聯的品質。
-
MCI_DGV_LIST_AUDIO_STREAM
-
命令應該會擷取音訊資料流程的名稱。
-
MCI_DGV_LIST_STILL_AL
-
命令應該擷取仍然演算法的名稱。
-
MCI_DGV_LIST_STILL_QUALITY
-
命令應該會擷取品質等級。 傳回的層級會與 lpList 所識別 之結構的 lpstrAlgorithm 成員所參考 的演算法相關聯。 如果使用字串 「current」 指定該成員，則會傳回與目前演算法相關聯的品質。
-
MCI_DGV_LIST_VIDEO_ALG
-
命令應擷取影片演算法的名稱。
-
MCI_DGV_LIST_VIDEO_QUALITY
-
命令應擷取視訊品質層級。 傳回的層級會與 lpList 所識別 之結構的 lpstrAlgorithm 成員所參考 的演算法相關聯。 如果使用字串 「current」 指定該成員，則會傳回與目前演算法相關聯的品質。
-
MCI_DGV_LIST_VIDEO_SOURCE
-
命令應該會傳回影片來源的相關資訊。 搭配 MCI_DGV_LIST_COUNT 使用時，命令會傳回視訊來源的數目。 搭配MCI_DGV_LIST_NUMBER使用時，命令會傳回視訊來源的類型。 MCI 會定義下列類型：
- MCI_DGV_SETVIDEO_SRC_GENERIC
- MCI_DGV_SETVIDEO_SRC_NTSC
- MCI_DGV_SETVIDEO_SRC_PAL
- MCI_DGV_SETVIDEO_SRC_RGB
- MCI_DGV_SETVIDEO_SRC_SECAM
- MCI_DGV_SETVIDEO_SRC_SVIDEO
傳回的每個類型可能有多個來源。 當該連接器允許多個訊號類型時，會使用泛型來源類型。
-
MCI_DGV_LIST_VIDEO_STREAM
-
命令應該會擷取視訊串流的名稱。
-
MCI_DGV_LIST_NUMBER
-
索引是在 lpList 所 識別結構的 dwNumber 成員中 指定。 索引必須是介於 1 和針對MCI_DGV_LIST_COUNT旗標傳回的值之間的整數。
對於數位視訊裝置， lpList 會指向 MCI_DGV_LIST_PARMS 結構。
下列其他旗標適用于 vcr 裝置類型：
-
MCI_VCR_LIST_AUDIO_SOURCE
-
列出音訊輸入或類型。
-
MCI_VCR_LIST_COUNT
-
將 lpList 所 識別結構的 dwReturn 成員設定為視訊或音訊輸入的總數。
-
MCI_VCR_LIST_NUMBER
-
將 lpList 所 識別結構的 dwReturn 成員設定為 dwNumber 成員所 指定的視訊或音訊輸入類型。
-
MCI_VCR_LIST_VIDEO_SOURCE
-
列出視訊輸入或類型。
針對 VCR 裝置， lpList 會指向 MCI_VCR_LIST_PARMS 結構。
需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
| 頁首 |
|