Messaggi di comando

[La funzionalità associata a questa pagina, MCI, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di MCI, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'interfaccia del messaggio di comando è progettata per essere usata dalle applicazioni che richiedono un'interfaccia del linguaggio C per controllare i dispositivi multimediali. Usa un paradigma di passaggio dei messaggi per comunicare con i dispositivi MCI. È possibile inviare un comando usando la funzione mciSendCommand.

La funzione mciSendCommand restituisce zero se ha esito positivo. Se la funzione ha esito negativo, la parola con ordine basso del valore restituito contiene un codice di errore. È possibile passare questo codice di errore alla funzionemciGetErrorStringper ottenere una descrizione testuale dell'errore.

Sintassi dei messaggi di comando

I messaggi di comando MCI sono costituiti dagli elementi seguenti:

• Valore del messaggio costante
• Struttura contenente parametri per il comando
• Set di flag che specificano le opzioni per il comando e la convalida dei campi nel blocco di parametri

Nell'esempio seguente viene usata la funzionemciSendCommand per inviare il comandoPLAYMCI_ al dispositivo identificato da un identificatore del dispositivo.

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

L'identificatore del dispositivo specificato nel primo parametro viene recuperato quando il dispositivo viene aperto usando il comando MCI_ OPEN. L'ultimo parametro è l'indirizzo di una struttura di MCI_ PLAY_ PARMS, che può contenere informazioni su dove iniziare e terminare la riproduzione. Molti messaggi di comando MCI usano una struttura per contenere parametri di questo tipo. Il primo membro di ognuna di queste strutture identifica la finestra che riceve un messaggio di MM_ MCINOTIFY al termine dell'operazione.