MCI_INFO命令

MCI_INFO命令會從裝置擷取字串資訊。所有裝置都會辨識此命令。資訊會在lpInfo所識別之結構的lpstrReturn成員中傳回。 dwRetSize成員會指定傳回資料的緩衝區長度。

若要傳送此命令，請使用下列參數呼叫 mciSendCommand 函式。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_INFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_INFO_PARMS) lpInfo
);

參數

wDeviceID: 要接收命令訊息之 MCI 裝置的裝置識別碼。
dwFlags: MCI_NOTIFY、MCI_WAIT或數位視訊和 VCR 裝置MCI_TEST。如需這些旗標的相關資訊，請參閱 Wait、Notify 和 Test Flags。
lpInfo: MCI_INFO_PARMS結構的指標。 (具有擴充命令集的裝置，可能會以裝置特定的結構取代此結構。)

如果成功或發生錯誤，則傳回零。

下列額外的標準和命令特定旗標適用于支援MCI_INFO的所有裝置：

下列其他旗標適用于 cdaudio 裝置類型：

MCI_INFO_MEDIA_IDENTITY: 針對目前在查詢的播放程式中載入的音訊 CD 產生唯一識別碼。此旗標會傳回 16 個十六進位數位的字串。
MCI_INFO_MEDIA_UPC: 產生以音訊 CD 編碼的通用產品名稱 () 。其為數字字串。它可能無法供所有 CD 使用。

下列其他旗標適用于 digitalvideo 裝置類型：

MCI_DGV_INFO_ITEM: 常數，指出所需的資訊會包含在lpInfo所識別結構的dwItem成員中。數位視訊裝置定義了下列常數：
MCI_DGV_INFO_AUDIO_ALG: 傳回目前音訊壓縮演算法的名稱。
MCI_DGV_INFO_AUDIO_QUALITY: 傳回目前音訊品質描述項的名稱。
MCI_DGV_INFO_STILL_ALG: 傳回目前仍在影像壓縮演算法的名稱。
MCI_DGV_INFO_STILL_QUALITY: 傳回目前仍在影像品質描述項的名稱。
MCI_DGV_INFO_USAGE: 傳回字串，描述工作區中視覺效果或可聽見資料的擁有者可能會加加的使用限制。
MCI_DGV_INFO_VIDEO_ALG: 傳回目前視訊壓縮演算法的名稱。
MCI_DGV_INFO_VIDEO_QUALITY: 傳回目前影片品質描述項的名稱。
MCI_INFO_VERSION: 傳回設備磁碟機和硬體的發行層級。設備磁碟機開發人員必須記錄傳回字串的語法。
MCI_DGV_INFO_TEXT: 取得視窗標題。
MCI_INFO_FILE: 取得使用 MCI_OPEN 或 MCI_LOAD 命令所指定最後一個檔案的路徑和檔案名。如果尚未指定檔案，裝置會傳回以 Null 結尾的字串。只有傳回 TRUE 給 MCI_GETDEVCAPS 命令之 MCI_GETDEVCAPS_USES_FILES 旗標的裝置才支援此旗標。

若為數字視訊裝置， lpInfo 會指向 MCI_DGV_INFO_PARMS 結構。

下列其他旗標適用于 排序器 裝置類型：

MCI_INFO_COPYRIGHT: 從著作權中繼事件取得 MIDI 檔案著作權聲明。
MCI_INFO_FILE: 取得目前檔案的檔案名。只有當您使用 MCI_GETDEVCAPS_USES_FILES 旗標呼叫MCI_GETDEVCAPS命令時，傳回TRUE的裝置才支援此旗標。
MCI_INFO_NAME: 從序列/追蹤名稱中繼事件取得序列名稱。

下列其他旗標適用于 vcr 裝置類型：

MCI_VCR_INFO_VERSION: 將MCI_INFO_PARMS結構的lpstrReturn成員設定為指向版本號碼。同時設定 dwRetSize 成員等於所指向字串的長度。

下列其他旗標適用于重迭裝置類型：

MCI_INFO_FILE: 取得目前檔案的檔案名。只有傳回 TRUE 給 MCI_GETDEVCAPS 命令之 MCI_GETDEVCAPS_USES_FILES 旗標的裝置才支援此旗標。
MCI_OVLY_INFO_TEXT: 取得與視訊重迭裝置相關聯的視窗標題。

下列其他旗標適用于 waveaudio 裝置類型：

MCI_INFO_FILE: 取得目前檔案的檔案名。當您使用 MCI_GETDEVCAPS_USES_FILES 旗標呼叫MCI_GETDEVCAPS命令時，會傳回TRUE的裝置支援此旗標。
MCI_WAVE_INPUT: 取得目前輸入的產品名稱。
MCI_WAVE_OUTPUT: 取得目前輸出的產品名稱，且其值是裝置特定的。