Share via


DRV_CONFIGURE Nachricht

Weist den installierbaren Treiber an, sein Konfigurationsdialogfeld anzuzeigen und dem Benutzer neue Einstellungen für den angegebenen installierbaren Treiber instance anzugeben.

Parameter

dwDriverId

Bezeichner des installierbaren Treibers. Dies ist der gleiche Wert, der zuvor vom Treiber aus der DRV_OPEN-Nachricht zurückgegeben wurde.

hdrvr

Handle des installierbaren Treibers instance.

lParam1

Handle des übergeordneten Fensters. Dieses Fenster wird als übergeordnetes Fenster für das Konfigurationsdialogfeld verwendet.

lParam2

Adresse einer DRVCONFIGINFO-Struktur oder NULL. Wenn die Struktur angegeben ist, enthält sie die Namen des Registrierungsschlüssels und des dem Treiber zugeordneten Werts.

Rückgabewert

Gibt einen der folgenden Werte zurück:

Anforderung Wert
DRVCNF_OK Die Konfiguration ist erfolgreich. es sind keine weiteren Maßnahmen erforderlich.
DRVCNF_CANCEL Der Benutzer hat das Dialogfeld abgebrochen. es sind keine weiteren Maßnahmen erforderlich.
DRVCNF_RESTART Die Konfiguration ist erfolgreich, aber die Änderungen werden erst wirksam, wenn das System neu gestartet wird.

Bemerkungen

Einige installierbare Treiber fügen Konfigurationsinformationen an den Wert an, der dem dem Treiber zugeordneten Registrierungswert zugewiesen ist.

Die DRV_CANCEL-, DRV_OK- und DRV_RESTART-Rückgabewerte sind veraltet. sie wurden durch DRVCNF_CANCEL, DRVCNF_OK und DRVCNF_RESTART ersetzt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Mmsystem.h (einschließlich Windows.h)

Weitere Informationen

Installierbare Treiber

Installierbare Treibermeldungen