info 命令

  • 發行項

info 命令會從裝置擷取硬體描述。 所有 MCI 裝置都會辨識此命令。

若要傳送此命令，請使用lpszCommand參數集呼叫mciSendString函式，如下所示。

_stprintf_s(
  lpszCommand, 
  TEXT("info %s %s %s"), 
  lpszDeviceID, 
  lpszInfoType, 
  lpszFlags
);

參數

lpszDeviceID

MCI 裝置的識別碼。 當裝置開啟時，會指派此識別碼或別名。

lpszInfoType

識別所需資訊類型的旗標。 下表列出可辨識每個類型所使用 資訊 命令和旗標的裝置類型。

值 意義 意義
cdaudio info identityinfo 登入 product
digitalvideo audio algorithmaudio qualityfileproductstill algorithmstill quality usageversionvideo algorithmvideo qualitywindow text
overlay fileproduct 視窗文字
排序器 copyrightfile nameproduct
錄影機 product version
videodisk product
waveaudio fileinput outputproduct

下表列出可以在 lpszInfoType 參數及其意義中指定的旗標。

值 意義
音訊演算法 傳回目前音訊壓縮演算法的名稱。
音訊品質 傳回目前音訊品質描述項的名稱。 如果應用程式已將參數設定為未對應至已定義品質的特定值，這可能會傳回「未知」。
著作權 從著作權中繼事件擷取 MIDI 檔案著作權聲明。
檔案 擷取複合裝置所使用的檔案名。 如果裝置未開啟檔案，且尚未使用 load 命令，則會傳回 Null 字串。
資訊身分識別 針對目前在查詢的播放程式中載入的音訊 CD 產生唯一識別碼。
infoup 產生以音訊 CD 編碼的通用產品名稱 () 。 其為數字字串。 它可能無法供所有 CD 使用。
input 擷取目前輸入裝置的描述。 如果未設定輸入裝置，則會傳回「無」。
NAME 從序列/追蹤名稱中繼事件擷取序列名稱。
output 擷取目前輸出裝置的描述。 如果未設定輸出裝置，則會傳回 「無」。
product 擷取裝置的描述。 此資訊通常包含產品名稱和模型。 字串長度會是 31 個字元或更少。
仍然演算法 傳回目前仍在影像壓縮演算法的名稱。
仍然品質 傳回目前仍在影像品質描述項的名稱。 如果應用程式已將參數設定為未對應至已定義品質的特定值，這可能會傳回「未知」。
usage 傳回字串，描述工作區中視覺效果或音訊資料的擁有者可能會加加的使用限制。
version 傳回設備磁碟機和硬體的發行層級。
影片演算法 傳回目前視訊壓縮演算法的名稱。
視訊品質 傳回目前影片品質描述項的名稱。 如果應用程式已將參數設定為未對應至已定義品質的特定值，這可能會傳回「未知」。
視窗文字 擷取裝置所使用的視窗標題。

lpszFlags

可以是 「wait」、「notify」 或兩者。 對於數位視訊和 VCR 裝置，也可以指定「測試」。 如需這些旗標的詳細資訊，請參閱 Wait、Notify 和 Test Flags。

傳回值

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

範例

下列命令會擷取與 「mysound」 裝置相關聯的硬體描述。

info mysound product

規格需求

需求 值
最低支援的用戶端
 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限傳統型應用程式]

另請參閱

Mci

MCI 命令字串

載入