Fonction de rappel DRIVERPROC (mmiscapi.h)

Article
08/24/2023

Traite les messages du pilote pour le pilote installable. DriverProc est une fonction fournie par le pilote.

Syntaxe

DRIVERPROC Driverproc;

LRESULT Driverproc(
  DWORD_PTR unnamedParam1,
  HDRVR unnamedParam2,
  UINT unnamedParam3,
  LPARAM unnamedParam4,
  LPARAM unnamedParam5
)
{...}

Paramètres

unnamedParam1

Identificateur du pilote installable.

unnamedParam2

Handle du pilote installable instance. Chaque instance du pilote installable a un handle unique.

unnamedParam3

Valeur du message du pilote. Il peut s’agir d’une valeur personnalisée ou de l’une des valeurs standard suivantes :

Valeur	Signification
DRV_CLOSE	Avertit le pilote qu’il doit décrémenter son nombre d’utilisation et décharger le pilote si le nombre est égal à zéro.
DRV_CONFIGURE	Avertit le pilote qu’il doit afficher une boîte de dialogue de configuration. Ce message est envoyé uniquement si le pilote retourne une valeur différente de zéro lors du traitement du message DRV_QUERYCONFIGURE .
DRV_DISABLE	Avertit le pilote que sa mémoire allouée est sur le point d’être libérée.
DRV_ENABLE	Avertit le pilote qu’il a été chargé ou rechargé ou que Windows a été activé.
DRV_FREE	Avertit le pilote qu’il sera ignoré.
DRV_INSTALL	Avertit le pilote qu’il a été correctement installé.
DRV_LOAD	Avertit le pilote qu’il a été correctement chargé.
DRV_OPEN	Avertit le pilote qu’il est sur le point d’être ouvert.
DRV_POWER	Avertit le pilote que la source d’alimentation de l’appareil est sur le point d’être activée ou désactivée.
DRV_QUERYCONFIGURE	Indique au pilote s’il prend en charge le message DRV_CONFIGURE .
DRV_REMOVE	Avertit le pilote qu’il est sur le point d’être supprimé du système.

unnamedParam4

Valeur spécifique au message 32 bits.

unnamedParam5

Valeur spécifique au message 32 bits.

Valeur retournée

Retourne une valeur différente de zéro en cas de réussite ou de zéro dans le cas contraire.

Notes

Lorsque msg est DRV_OPEN, lParam1 est la chaîne suivant le nom du pilote du fichier SYSTEM.INI et lParam2 est la valeur donnée en tant que paramètre lParam dans un appel à la fonction OpenDriver .

Lorsque msg est DRV_CLOSE, lParam1 et lParam2 sont les mêmes valeurs que les paramètres lParam1 et lParam2 dans un appel à la fonction CloseDriver .

Spécifications


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, Windows.h)

Voir aussi

Fonctions du pilote

Pilotes installables

Partager via