CM_Setup_DevNode-Funktion (cfgmgr32.h)

Die CM_Setup_DevNode-Funktion startet ein Gerät instance neu, das nicht ausgeführt wird, da ein Problem mit der Gerätekonfiguration vorliegt.

Syntax

CMAPI CONFIGRET CM_Setup_DevNode(
  [in] DEVINST dnDevInst,
  [in] ULONG   ulFlags
);

Parameter

[in] dnDevInst

Ein Gerät instance Handle, das an das lokale System gebunden ist.

[in] ulFlags

Einer der folgenden Flagwerte:

CM_SETUP_DEVNODE_READY

Startet ein Gerät instance neu, das aufgrund eines Problems mit der Gerätekonfiguration nicht ausgeführt wird.

CM_SETUP_DEVNODE_RESET (Windows XP und höhere Versionen von Windows)

Setzt ein Gerät instance zurück, für das das Flag "Gerät ohne Neustart" status festgelegt ist. Das Flag "Gerät status neustarten" wird festgelegt, wenn ein Gerät entfernt wird, indem CM_Query_And_Remove_SubTree oder CM_Query_And_Remove_SubTree_Ex aufgerufen und das CM_REMOVE_NO_RESTART-Flag angegeben wird.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der Fehlercodes mit dem Präfix "CR_" zurückgegeben, die in Cfgmgr32.h definiert sind.

Hinweise

Geräteinstallationsanwendungen sollten die DIF_PROPERTYCHANGE-Anforderung verwenden, um ein Gerät neu zu starten, anstatt diese Funktion zu verwenden. Die DIF_PROPERTYCHANGE Anforderung kann verwendet werden, um die Eigenschaften eines Geräts zu aktivieren, zu deaktivieren, neu zu starten, zu beenden oder zu ändern.

Wenn ein Gerät instance kein Problem hat und bereits gestartet wurde, wird CM_Setup_DevNode zurückgegeben, ohne die status des Geräts instance zu ändern.

Rufen Sie CM_Get_DevNode_Status oder CM_Get_DevNode_Status_Ex auf, um die status und den Problemcode für ein Gerät instance zu ermitteln.

Anforderungen

Weitere Informationen

CM_Get_DevNode_Status

CM_Get_DevNode_Status_Ex

CM_Query_And_Remove_SubTree

CM_Query_And_Remove_SubTree_Ex

DIF_PROPERTYCHANGE