MM_MCINOTIFY mensagem
A mensagem MM_MCINOTIFY notifica um aplicativo de que um dispositivo MCI concluiu uma operação. Os dispositivos MCI enviam essa mensagem somente quando o sinalizador MCI_NOTIFY é usado.
MM_MCINOTIFY
wParam = (WPARAM) wFlags
lParam = (LONG) lDevID
Parâmetros
-
Wflags
-
Motivo da notificação. Os seguintes valores são definidos:
Requisito Valor MCI_NOTIFY_ABORTED O dispositivo recebeu um comando que impedia que as condições atuais para iniciar a função de retorno de chamada fossem atendidas. Se um novo comando interromper o comando atual e também solicitar notificação, o dispositivo enviará essa mensagem apenas e não MCI_NOTIFY_SUPERSEDED MCI_NOTIFY_FAILURE Ocorreu um erro de dispositivo enquanto o dispositivo executava o comando. MCI_NOTIFY_SUCCESSFUL As condições que iniciam a função de retorno de chamada foram atendidas. MCI_NOTIFY_SUPERSEDED O dispositivo recebeu outro comando com o sinalizador "notify" definido e as condições atuais para iniciar a função de retorno de chamada foram substituídas. -
lDevID
-
Identificador do dispositivo que inicia a função de retorno de chamada.
Valor Retornado
Retornará zero se tiver êxito ou um erro, caso contrário.
Comentários
Para obter mais informações sobre o sinalizador MCI_NOTIFY, consulte O Sinalizador de Notificação.
Um dispositivo retorna o sinalizador MCI_NOTIFY_SUCCESSFUL com MM_MCINOTIFY quando a ação de um comando é concluída. Por exemplo, um dispositivo de áudio cd usa esse sinalizador para notificação para o comando reproduzir ( MCI_PLAY) quando o dispositivo termina de ser reproduzido. O comando play é bem-sucedido somente quando atinge a posição final especificada ou atinge o final da mídia. Da mesma forma, os comandos seek ( MCI_SEEK) e record ( MCI_RECORD) não retornam MCI_NOTIFY_SUCCESSFUL até atingirem a posição final especificada ou chegarem ao final da mídia.
Um dispositivo retorna o sinalizador MCI_NOTIFY_ABORTED com MM_MCINOTIFY somente quando recebe um comando que o impede de atender às condições de notificação. Por exemplo, o comando play não anularia a notificação de um comando de reprodução anterior, desde que o novo comando não altere a direção de reprodução nem altere a posição final. Os comandos seek e record se comportam da mesma forma. O MCI também não envia MCI_NOTIFY_ABORTED quando a reprodução ou gravação é pausada com o comando pause ( MCI_PAUSE). O envio do comando resume ( MCI_RESUME) permite que eles continuem a atender às condições de retorno de chamada.
Quando o aplicativo solicita uma notificação para um comando, marcar o retorno de erro das funções mciSendString ou mciSendCommand. Se essas funções encontrarem um erro e retornarem um valor diferente de zero, o MCI não definirá a notificação para o comando.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|