共用方式為

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。

備註

用戶端會指定如何在裝置開啟時通知它。 DCB_FUNCTION和DCB_WINDOW旗標相當於開啟裝置時，在DRV_OPEN訊息的 lParam2 參數中指定的對應旗標CALLBACK_FUNCTION和CALLBACK_WINDOW的高序字。

如果使用回呼函式完成通知， hdrvr、 msg、 dwUser、 dwParam1 和 dwParam2 就會傳遞至回 呼 函式。 如果通知是透過視窗來完成，則只會將 msg、 hdrvr 和 dwParam1 傳遞至視窗。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mmiscapi.h (包含 Mmiscapi.h)
程式庫 Winmm.lib
Dll Winmm.dll

另請參閱

驅動程式函式

可安裝驅動程式