Partager via


DRV_CONFIGURE message

Indique au pilote installable d’afficher sa boîte de dialogue de configuration et de laisser l’utilisateur spécifier de nouveaux paramètres pour le pilote installable donné instance.

Paramètres

dwDriverId

Identificateur du pilote installable. Il s’agit de la même valeur précédemment retournée par le pilote à partir du message DRV_OPEN .

hdrvr

Handle du pilote installable instance.

lParam1

Handle de la fenêtre parente. Cette fenêtre est utilisée comme fenêtre parente pour la boîte de dialogue de configuration.

lParam2

Adresse d’une structure DRVCONFIGINFO ou NULL. Si la structure est donnée, elle contient les noms de la clé de Registre et de la valeur associée au pilote.

Valeur renvoyée

Retourne l’une des valeurs suivantes :

Condition requise Valeur
DRVCNF_OK La configuration est réussie ; aucune autre action n’est requise.
DRVCNF_CANCEL L’utilisateur a annulé la boîte de dialogue ; aucune autre action n’est requise.
DRVCNF_RESTART La configuration réussit, mais les modifications n’entrent pas en vigueur tant que le système n’est pas redémarré.

Notes

Certains pilotes installables ajoutent des informations de configuration à la valeur affectée à la valeur de Registre associée au pilote.

Les valeurs de retour DRV_CANCEL, DRV_OK et DRV_RESTART sont obsolètes ; ils ont été remplacés par DRVCNF_CANCEL, DRVCNF_OK et DRVCNF_RESTART, respectivement.

Spécifications

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]
En-tête
Mmsystem.h (inclure Windows.h)

Voir aussi

Pilotes installables

Messages de pilote installables