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 [僅限傳統型應用程式]
頁首
Mmsystem.h （包括 Windows.h）

另請參閱

Mci

MCI 命令