DriverCallback, fonction (mmiscapi.h)

Article
03/04/2024

Appelle une fonction de rappel, envoie un message à une fenêtre ou débloque un thread. L’action dépend de la valeur de l’indicateur de notification. Cette fonction est destinée à être utilisée uniquement dans la fonction DriverProc d’un pilote installable.

Syntaxe

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

Paramètres

dwCallback

Adresse de la fonction de rappel, d’un handle de fenêtre ou d’un handle de tâche, selon l’indicateur spécifié dans le paramètre dwFlags .

dwFlags

Indicateurs de notification. Il peut s'agir d'une des valeurs suivantes :

Valeur	Signification
DCB_NOSWITCH	Le système ne peut pas changer de pile. Cette valeur est utilisée uniquement si l’espace de pile pour la fonction de rappel est connu pour exister.
DCB_FUNCTION	Le paramètre dwCallback est l’adresse d’une fonction de rappel définie par l’application. Le système envoie le message de rappel à la fonction de rappel.
DCB_WINDOW	Le paramètre dwCallback est le handle d’une fenêtre définie par l’application. Le système envoie les notifications suivantes à la fenêtre.
DCB_TASK	Le paramètre dwCallback est le handle d’une application ou d’une tâche. Le système envoie les notifications suivantes à l’application ou à la tâche.

hDevice

Handle du pilote installable instance.

dwMsg

Valeur de message.

dwUser

Données instance utilisateur 32 bits fournies par l’application lors de l’ouverture de l’appareil.

dwParam1

Paramètre 32 bits dépendant du message.

dwParam2

Paramètre 32 bits dépendant du message.

Valeur retournée

Retourne TRUE en cas de réussite ou FALSE si un paramètre n’est pas valide ou si la file d’attente de messages de la tâche est pleine.

Remarques

Le client spécifie comment le notifier lors de l’ouverture de l’appareil. Les indicateurs DCB_FUNCTION et DCB_WINDOW sont équivalents au mot d’ordre supérieur des indicateurs correspondants CALLBACK_FUNCTION et CALLBACK_WINDOW spécifiés dans le paramètre lParam2 du message DRV_OPEN lors de l’ouverture de l’appareil.

Si la notification est effectuée avec une fonction de rappel, hdrvr, msg, dwUser, dwParam1 et dwParam2 sont passés à la fonction de rappel. Si la notification est effectuée au moyen d’une fenêtre, seuls msg, hdrvr et dwParam1 sont passés à la fenêtre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mmiscapi.h (inclure Mmiscapi.h)
Bibliothèque	Winmm.lib
DLL	Winmm.dll

Voir aussi

Fonctions du pilote

Pilotes installables

Partager via