Zprávy příkazů

[Funkce přidružená k této stránce, MCI, je starší funkce. Byla nahrazena MediaPlayer. MediaPlayer je optimalizovaný pro Windows 10 a Windows 11. Microsoft důrazně doporučuje, aby nový kód používal MediaPlayer místo MCI, pokud je to možné. Microsoft navrhuje, aby se stávající kód, který používá starší rozhraní API, přepsal, aby se nová rozhraní API používala, pokud je to možné.]

Rozhraní příkazové zprávy je navržené tak, aby je používaly aplikace vyžadující rozhraní jazyka C pro ovládání multimediálních zařízení. Používá paradigma předávání zpráv ke komunikaci se zařízeními MCI. Příkaz můžete odeslat pomocí funkce mciSendCommand.

Funkce mciSendCommand vrátí nulu, pokud je úspěšná. Pokud funkce selže, slovo s nízkým pořadím návratové hodnoty obsahuje kód chyby. Tento kód chyby můžete předat funkci mciGetErrorString a získat textový popis chyby.

Syntaxe zpráv příkazů

Zprávy příkazů MCI se skládají z následujících prvků:

• Konstantní hodnota zprávy
• Struktura obsahující parametry pro příkaz
• Sada příznaků určujících možnosti pro příkaz a ověřování polí v bloku parametrů

Následující příklad používá funkci mciSendCommand k odeslání příkazu MCI_ PLAY do zařízení identifikovaného identifikátorem zařízení.

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

Identifikátor zařízení zadaný v prvním parametru se načte při otevření zařízení pomocí příkazu MCI_ OPEN. Poslední parametr je adresa struktury MCI_ PLAY_ PARMS, která může obsahovat informace o tom, kde začít a ukončit přehrávání. Mnoho zpráv příkazů MCI používá strukturu, která obsahuje parametry tohoto typu. První člen každé z těchto struktur identifikuje okno, které obdrží MM_ MCINOTIFY zprávu po dokončení operace.