messaggio di MM_MCINOTIFY

Il messaggio MM_MCINOTIFY notifica a un'applicazione che un dispositivo MCI ha completato un'operazione. I dispositivi MCI inviano questo messaggio solo quando viene usato il flag MCI_NOTIFY.

MM_MCINOTIFY 
wParam = (WPARAM) wFlags 
lParam = (LONG) lDevID

Parametri

Wflags

Motivo della notifica. Vengono definiti i valori seguenti:

Requisito	Valore
MCI_NOTIFY_ABORTED	Il dispositivo ha ricevuto un comando che ha impedito di soddisfare le condizioni correnti per avviare la funzione di callback. Se un nuovo comando interrompe il comando corrente e richiede anche la notifica, il dispositivo invia questo messaggio solo e non MCI_NOTIFY_SUPERSEDED
MCI_NOTIFY_FAILURE	Si è verificato un errore del dispositivo durante l'esecuzione del comando.
MCI_NOTIFY_SUCCESSFUL	Sono state soddisfatte le condizioni che avviano la funzione di callback.
MCI_NOTIFY_SUPERSEDED	Il dispositivo ha ricevuto un altro comando con il flag "notify" impostato e le condizioni correnti per l'avvio della funzione di callback sono state sostituite.

lDevID

Identificatore del dispositivo che avvia la funzione di callback.

Valore restituito

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

Commenti

Per altre informazioni sul flag di MCI_NOTIFY, vedere Il flag di notifica.

Un dispositivo restituisce il flag MCI_NOTIFY_SUCCESSFUL con MM_MCINOTIFY al termine dell'azione per un comando. Ad esempio, un dispositivo audio CD usa questo flag per la notifica per il comando play ( MCI_PLAY) al termine della riproduzione del dispositivo. Il comando play ha esito positivo solo quando raggiunge la posizione finale specificata o raggiunge la fine del supporto. Analogamente, i comandi seek ( MCI_SEEK) e record ( MCI_RECORD) non restituiscono MCI_NOTIFY_SUCCESSFUL finché non raggiungono la posizione finale specificata o raggiungono la fine del supporto.

Un dispositivo restituisce il flag di MCI_NOTIFY_ABORTED con MM_MCINOTIFY solo quando riceve un comando che impedisce che soddisfi le condizioni di notifica. Ad esempio, il comando play non interromperà la notifica per un comando di riproduzione precedente a condizione che il nuovo comando non modificherà la direzione di riproduzione o cambierà la posizione finale. I comandi seek e record si comportano in modo analogo. MCI non invia inoltre MCI_NOTIFY_ABORTED quando la riproduzione o la registrazione viene sospesa con il comando pause ( MCI_PAUSE). L'invio del comando resume ( MCI_RESUME) consente di continuare a soddisfare le condizioni di callback.

Quando l'applicazione richiede una notifica per un comando, controllare la restituzione dell'errore delle funzioni mciSendString o mciSendCommand . Se queste funzioni rilevano un errore e restituiscono un valore diverso da zero, MCI non imposterà la notifica per il comando.

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

Messaggi MCI

Pausa

Giocare

Registrazione

riassumere

Cercare