Condividi tramite

Messaggi di comando

  • Articolo

[La funzionalità associata a questa pagina, MCI, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché 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 a basso ordine del valore restituito contiene un codice di errore. È possibile passare questo codice di errore alla funzione mciGetErrorString per ottenere una descrizione del testo 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 funzione mciSendCommand per inviare il comando PLAY MCI_ 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 PARMS MCI_ PLAY_ , che potrebbe 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 MM_ MCINOTIFY al termine dell'operazione.