comando MCI_STOP

  • Articolo

Il comando MCI_STOP arresta tutte le sequenze di riproduzione e record, scarica tutti i buffer di riproduzione e termina la visualizzazione delle immagini video. Audio CD, digital-video, midi sequencer, videodisc, VCR e dispositivi waveform-audio riconosce questo comando.

Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_STOP, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpStop
);

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

Dwflags

MCI_NOTIFY, MCI_WAIT o, per i dispositivi digital-video e VCR, MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.

lpStop

Puntatore a una struttura MCI_GENERIC_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

La differenza tra i comandi MCI_STOP e MCI_PAUSE dipende dal dispositivo. Se possibile, MCI_PAUSE sospende l'operazione del dispositivo, ma lascia il dispositivo pronto per riprendere immediatamente la riproduzione.

Per il dispositivo audio CD, MCI_STOP reimposta la posizione di traccia corrente su zero; al contrario, MCI_PAUSE mantiene la posizione di traccia corrente, anticipando che il dispositivo riprenderà a giocare.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]
Intestazione
Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI