Share via

Función DriverCallback (mmiscapi.h)

  • Artículo

Llama a una función de devolución de llamada, envía un mensaje a una ventana o desbloquea un subproceso. La acción depende del valor de la marca de notificación. Esta función está pensada para usarse solo dentro de la función DriverProc de un controlador instalable.

Sintaxis

BOOL DriverCallback(
  DWORD_PTR dwCallback,
  DWORD     dwFlags,
  HDRVR     hDevice,
  DWORD     dwMsg,
  DWORD_PTR dwUser,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2
);

Parámetros

dwCallback

Dirección de la función de devolución de llamada, un identificador de ventana o un identificador de tarea, según la marca especificada en el parámetro dwFlags .

dwFlags

Marcas de notificación. Puede ser uno de estos valores:

Valor Significado
DCB_NOSWITCH
 Se impide que el sistema cambie de pilas. Este valor solo se usa si se sabe que existe suficiente espacio de pila para la función de devolución de llamada.
DCB_FUNCTION
 El parámetro dwCallback es la dirección de una función de devolución de llamada definida por la aplicación. El sistema envía el mensaje de devolución de llamada a la función de devolución de llamada.
DCB_WINDOW
 El parámetro dwCallback es el identificador de una ventana definida por la aplicación. El sistema envía notificaciones posteriores a la ventana.
DCB_TASK
 El parámetro dwCallback es el identificador de una aplicación o tarea. El sistema envía notificaciones posteriores a la aplicación o tarea.

hDevice

Identificador de la instancia de controlador instalable.

dwMsg

Valor del mensaje.

dwUser

Datos de instancia de usuario de 32 bits proporcionados por la aplicación cuando se abrió el dispositivo.

dwParam1

Parámetro dependiente del mensaje de 32 bits.

dwParam2

Parámetro dependiente del mensaje de 32 bits.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE si un parámetro no es válido o la cola de mensajes de la tarea está llena.

Comentarios

El cliente especifica cómo notificarlo cuando se abre el dispositivo. Las marcas DCB_FUNCTION y DCB_WINDOW son equivalentes a la palabra de orden superior de las marcas correspondientes CALLBACK_FUNCTION y CALLBACK_WINDOW especificadas en el parámetro lParam2 del mensaje de DRV_OPEN cuando se abrió el dispositivo.

Si la notificación se realiza con una función de devolución de llamada, hdrvr, msg, dwUser, dwParam1 y dwParam2 se pasan a la función de devolución de llamada. Si la notificación se realiza mediante una ventana, solo se pasan msg, hdrvr y dwParam1 a la ventana.

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]
Plataforma de destino Windows
Encabezado mmiscapi.h (incluya Mmiscapi.h)
Library Winmm.lib
Archivo DLL Winmm.dll

Consulte también

Funciones de controlador

Controladores instalables