MCI_SYSINFO命令
MCI_SYSINFO 命令會擷取 MCI 裝置的相關資訊。 MCI 直接支援此命令，而不是將它傳遞至裝置。 任何 MCI 應用程式都可以使用此命令。 字串資訊會在由lpSysInfo所識別之結構的lpstrReturn成員所指向的應用程式提供緩衝區中傳回。 數值資訊會以 DWORD 值的形式傳回，放在應用程式提供的緩衝區中。 dwRetSize成員會指定緩衝區長度。
若要傳送此命令，請使用下列參數呼叫 mciSendCommand 函式。
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_SYSINFO,
DWORD dwFlags,
(DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);
參數
-
wDeviceID
-
要接收命令訊息之 MCI 裝置的裝置識別碼。
-
dwFlags
-
下列一或多個標準和命令特定旗標：
-
MCI_SYSINFO_INSTALLNAME
-
取得登錄中所列的名稱 (，或用來安裝裝置的SYSTEM.INI檔案) 。
-
MCI_SYSINFO_NAME
-
取得對應至lpSysInfo所識別結構之 dwNumber成員中所指定裝置編號的裝置名稱。 如果已設定MCI_SYSINFO_OPEN旗標，MCI 會傳回開啟裝置的名稱。
-
MCI_SYSINFO_OPEN
-
取得開啟裝置的數量或名稱。
-
MCI_SYSINFO_QUANTITY
-
取得SYSTEM.INI檔案的登錄或 [mci] 區段中所列指定型別的裝置數目。 如果已設定MCI_SYSINFO_OPEN旗標，則會傳回開啟的裝置數目。
-
lpSysInfo
-
MCI_SYSINFO_PARMS結構的指標。
傳回值
如果成功或發生錯誤，則傳回零。
備註
lpSysInfo所識別結構的wDeviceType成員是用來指出查詢的裝置類型。 如果 wDeviceID 參數設定為 MCI_ALL_DEVICE_ID，則會覆寫 wDeviceType的值。 如需裝置類型的清單，請參閱 MCI 裝置類型。
整數傳回值是在緩衝區中傳回的DWORD值，由lpSysInfo所識別之 結構的lpstrReturn成員所指向。
字串傳回值是以 Null 結束的字串，由lpSysInfo所識別結構的lpstrReturn成員所指向的緩衝區中傳回。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 標頭 |
|