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 命令字串