命令訊息

[與此頁面相關聯的功能 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 

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