命令訊息

[與此頁面 MCI相關聯的功能是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer 而非 MCI。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

命令訊息介面的設計目的是要供需要 C 語言介面來控制多媒體裝置的應用程式使用。 它會使用訊息傳遞範例來與 MCI 裝置通訊。 您可以使用 mciSendCommand 函式來傳送命令。

如果成功， mciSendCommand 函式會傳回零。 如果函式失敗，傳回值的低序字會包含錯誤碼。 您可以將此錯誤碼傳遞至 mciGetErrorString 函式，以取得錯誤的文字描述。

命令訊息的語法

MCI 命令訊息包含下列元素：

• 常數訊息值
• 結構，包含命令的參數
• 一組旗標，指定命令的選項，以及驗證參數區塊中的欄位

下列範例會使用 mciSendCommand 函式，將 MCI_ PLAY 命令傳送至裝置識別碼所識別的裝置。

mciSendCommand(wDeviceID,            // device identifier 
    MCI_PLAY,                        // command message 
    0,                               // flags 
    (DWORD)(LPVOID) &mciPlayParms);  // parameter block 

使用 MCI_ OPEN 命令開啟裝置時，會擷取第一個參數中指定的裝置識別碼。 最後一個參數是 MCI_ PLAY_ PARMS 結構的位址，其中可能包含開始和結束播放位置的相關資訊。 許多 MCI 命令訊息都會使用 結構來包含這種參數。 這些結構的第一個成員會識別在作業完成時接收 MM_ MCINOTIFY 訊息的視窗。