mensaje de MM_MCINOTIFY
El mensaje MM_MCINOTIFY notifica a una aplicación que un dispositivo MCI ha completado una operación. Los dispositivos MCI envían este mensaje solo cuando se usa la marca MCI_NOTIFY.
MM_MCINOTIFY
wParam = (WPARAM) wFlags
lParam = (LONG) lDevID
Parámetros
-
wFlags
-
Motivo de la notificación. Se definen los valores siguientes:
Requisito Value MCI_NOTIFY_ABORTED El dispositivo recibió un comando que impedía que se cumplan las condiciones actuales para iniciar la función de devolución de llamada. Si un nuevo comando interrumpe el comando actual y también solicita notificación, el dispositivo solo envía este mensaje y no MCI_NOTIFY_SUPERSEDED MCI_NOTIFY_FAILURE Se produjo un error de dispositivo mientras el dispositivo estaba ejecutando el comando . MCI_NOTIFY_SUCCESSFUL Se han cumplido las condiciones que inician la función de devolución de llamada. MCI_NOTIFY_SUPERSEDED El dispositivo recibió otro comando con la marca "notify" establecida y se han reemplazado las condiciones actuales para iniciar la función de devolución de llamada. -
lDevID
-
Identificador del dispositivo que inicia la función de devolución de llamada.
Valor devuelto
Devuelve cero si es correcto o si se produce un error en caso contrario.
Comentarios
Para obtener más información sobre la marca de MCI_NOTIFY, vea La marca de notificación.
Un dispositivo devuelve la marca MCI_NOTIFY_SUCCESSFUL con MM_MCINOTIFY cuando finaliza la acción de un comando. Por ejemplo, un dispositivo de audio de CD usa esta marca para la notificación del comando reproducir ( MCI_PLAY) cuando el dispositivo termina de reproducirse. El comando play solo se ejecuta correctamente cuando alcanza la posición final especificada o llega al final del medio. Del mismo modo, los comandos seek ( MCI_SEEK) y record ( MCI_RECORD) no devuelven MCI_NOTIFY_SUCCESSFUL hasta que lleguen a la posición final especificada o lleguen al final del medio.
Un dispositivo devuelve la marca de MCI_NOTIFY_ABORTED con MM_MCINOTIFY solo cuando recibe un comando que impide que cumpla las condiciones de notificación. Por ejemplo, el comando play no anularía la notificación de un comando de reproducción anterior siempre que el nuevo comando no cambie la dirección de la reproducción ni cambie la posición final. Los comandos seek y record se comportan de forma similar. MCI tampoco envía MCI_NOTIFY_ABORTED cuando la reproducción o la grabación se pausan con el comando pause ( MCI_PAUSE). El envío del comando resume ( MCI_RESUME) les permite seguir cumpliendo las condiciones de devolución de llamada.
Cuando la aplicación solicite una notificación para un comando, compruebe la devolución del error de las funciones mciSendString o mciSendCommand . Si estas funciones encuentran un error y devuelven un valor distinto de cero, MCI no establecerá la notificación para el comando.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
Encabezado |
|