Funzione DriverCallback (mmiscapi.h)

Articolo
03/05/2024

Chiama una funzione di callback, invia un messaggio a una finestra o sblocca un thread. L'azione dipende dal valore del flag di notifica. Questa funzione deve essere usata solo all'interno della funzione DriverProc di un driver installabile.

Sintassi

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

Parametri

dwCallback

Indirizzo della funzione di callback, un handle di finestra o un handle di attività, a seconda del flag specificato nel parametro dwFlags .

dwFlags

Flag di notifica. Può corrispondere a uno dei seguenti valori:

Valore	Significato
DCB_NOSWITCH	Il sistema non consente di cambiare stack. Questo valore viene usato solo se esiste abbastanza spazio dello stack per la funzione di callback.
DCB_FUNCTION	Il parametro dwCallback è l'indirizzo di una funzione di callback definita dall'applicazione. Il sistema invia il messaggio di callback alla funzione di callback.
DCB_WINDOW	Il parametro dwCallback è l'handle di una finestra definita dall'applicazione. Il sistema invia notifiche successive alla finestra.
DCB_TASK	Il parametro dwCallback è l'handle di un'applicazione o di un'attività. Il sistema invia notifiche successive all'applicazione o all'attività.

hDevice

Handle dell'istanza del driver installabile.

dwMsg

Valore del messaggio.

dwUser

Dati dell'istanza utente a 32 bit forniti dall'applicazione quando il dispositivo è stato aperto.

dwParam1

Parametro dipendente dal messaggio a 32 bit.

dwParam2

Parametro dipendente dal messaggio a 32 bit.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE se un parametro non è valido o la coda del messaggio dell'attività è piena.

Commenti

Il client specifica come notificarlo all'apertura del dispositivo. I flag DCB_FUNCTION e DCB_WINDOW sono equivalenti alla parola ad ordine elevato dei flag corrispondenti CALLBACK_FUNCTION e CALLBACK_WINDOW specificati nel parametro lParam2 del messaggio di DRV_OPEN quando il dispositivo è stato aperto.

Se la notifica viene eseguita con una funzione di callback, hdrvr, msg, dwUser, dwParam1 e dwParam2 vengono passati alla funzione di callback. Se la notifica viene eseguita tramite una finestra, viene passato alla finestra solo msg, hdrvr e dwParam1 .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mmiscapi.h (include Mmiscapi.h)
Libreria	Winmm.lib
DLL	Winmm.dll

Vedi anche

Funzioni driver

Driver installabili

Condividi tramite