閱讀英文

共用方式為


list 命令

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 [僅限傳統型應用程式]

另請參閱

Mci

MCI 命令字串