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。 如需這些旗標的相關資訊,請參閱 Wait、Notify 和 Test Flags

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 (include Windows.h)

另請參閱

MCI

MCI 命令