DriverCallback 函数 (mmiscapi.h)

  • 项目

调用回调函数、将消息发送到窗口或取消阻止线程。 操作取决于通知标志的值。 此函数仅用于可安装 驱动程序的 DriverProc 函数中。

语法

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

参数

dwCallback

回调函数、窗口句柄或任务句柄的地址，具体取决于 dwFlags 参数中指定的标志。

dwFlags

通知标志。 它可以是以下值之一：

值 含义
DCB_NOSWITCH
 系统无法切换堆栈。 仅当已知存在足够的回调函数堆栈空间时，才使用此值。
DCB_FUNCTION
 dwCallback 参数是应用程序定义的回调函数的地址。 系统将回调消息发送到回调函数。
DCB_WINDOW
 dwCallback 参数是应用程序定义的窗口的句柄。 系统将后续通知发送到窗口。
DCB_TASK
 dwCallback 参数是应用程序或任务的句柄。 系统将后续通知发送到应用程序或任务。

hDevice

可安装驱动程序实例的句柄。

dwMsg

消息值。

dwUser

打开设备时应用程序提供的 32 位用户实例数据。

dwParam1

32 位消息依赖参数。

dwParam2

32 位消息依赖参数。

返回值

如果成功，则返回 TRUE ;如果参数无效或任务的消息队列已满，则返回 FALSE 。

注解

客户端指定在打开设备时如何通知它。 DCB_FUNCTION和DCB_WINDOW标志等效于打开设备时在DRV_OPEN消息的 lParam2 参数中指定的相应标志CALLBACK_FUNCTION和 CALLBACK_WINDOW 的高序字。

如果使用回调函数完成通知， 则 hdrvr、 msg、 dwUser、 dwParam1 和 dwParam2 将传递给回调函数。 如果通知是通过窗口完成的，则仅 将 msg、 hdrvr 和 dwParam1 传递到窗口。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mmiscapi.h (包括 Mmiscapi.h)
Library Winmm.lib
DLL Winmm.dll

另请参阅

驱动程序函数

可安装的驱动程序