list 命令會決定視訊和音訊輸入的數目和類型。 數位視訊和 VCR 裝置可辨識此命令。
若要傳送此命令，請使用lpszCommand參數集呼叫mciSendString函式，如下所示。
_stprintf_s(
lpszCommand,
TEXT("list %s %s %s"),
lpszDeviceID,
lpszList,
lpszFlags
);
參數
-
lpszDeviceID
-
MCI 裝置的識別碼。 當裝置開啟時，會指派此識別碼或別名。
-
lpszList
-
識別視訊和音訊輸入數目和類型的旗標。 下表列出可辨識 清單 命令的裝置類型，以及每種類型所使用的旗標。
值 意義 意義 digitalvideo 音訊演算法audio 品質演算法 音訊streamcountnumber 索引 仍在演算法 品質演算法演算法影片演算法video 品質演算法視訊來源視訊串流 錄影機 音訊來源 countaudio 來源編號 索引 視訊來源計數video 來源編號 索引 下表列出可以在 lpszList 參數及其意義中指定的旗標。
值 意義 音訊演算法 指定命令應該擷取音訊演算法名稱。 音訊 品質演算法 指定命令應該擷取與指定 演算法相關聯的品質等級。 如果 演算法 為「目前」，則會傳回目前演算法的品質等級。 音訊來源計數 傳回音頻輸入的總數。 音訊來源編號 索引 傳回來源 索引的音訊輸入類型。 音訊資料流程 指定命令應該擷取與工作區相關聯的音訊資料流程名稱。 這些字串 (例如「英文」或「德文」) 內嵌在檔案中，並識別資料流程。 count 傳回指定型別的選項數目。 number index 傳回字串，描述指定選項類型的 索引) 所識別的特定選項 (。 Index 必須是介於 1 到 「count」 所傳回值的整數。 仍然演算法 指定命令應該擷取仍然演算法名稱。 仍然 品質演算法 指定命令應該擷取與指定之仍在 演算法相關聯的品質等級。 如果 演算法 為「目前」，則會傳回目前演算法的品質等級。 影片演算法 指定命令應該擷取視訊演算法名稱。 視訊品質演算法 演算法 指定命令應該擷取與指定視訊 演算法相關聯的品質等級。 如果 演算法 為「目前」，則會傳回目前演算法的品質等級。 視訊來源 指定命令應該傳回影片來源的相關資訊。 搭配 「計數」旗標使用時，它會傳回視訊來源的數目。 搭配 「數位」旗標使用時，它會傳回視訊來源的類型。 MCI 會定義類型的下列常數：「ntsc」、「rgb」、「pal」、「secam」、「svideo」 和 「generic」。 每個類型可能會傳回一個以上的來源。 當該連接器允許多個訊號時，就會使用「泛型」來源類型。 視訊來源計數 傳回視訊輸入的總數。 視訊來源編號 索引 傳回來源 索引的視訊輸入類型。 視訊串流 指定命令應該擷取與工作區相關聯的視訊串流名稱。 這些字串 (，例如「打字結束」或「快樂結束」) 會內嵌在檔案中，並識別資料流程。 -
lpszFlags
-
可以是 「wait」、「notify」 或 「test」。 如需這些旗標的詳細資訊，請參閱 Wait、Notify 和 Test Flags。
傳回值
如果成功或發生錯誤，則傳回零。
備註
針對 VCR 裝置，「視訊來源」或「音訊來源」都必須使用「計數」或「數位」旗標來指定。 如果指定 「計數」，則會傳回視訊或音訊的輸入總數。 如果指定了 「number」，驅動程式會傳回對應至輸入的類型。 此類型可以是下列任一項：「tuner」、「line」、「svideo」、「aux」 或 「generic」。 一般而言，您應該先查詢 VCR 中的 「count」，然後使用 count 做為 「number」 旗標的範圍。 「source」 數位從 1 開始。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |