Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die CM_Reenumerate_DevNode-Funktion listet die Geräte auf, die von einem angegebenen Geräteknoten und allen untergeordneten Elementen identifiziert werden.
Syntax
CMAPI CONFIGRET CM_Reenumerate_DevNode(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Die Parameter
[in] dnDevInst
Vom Aufrufer bereitgestelltes Geräteinstanzhandle, das an den lokalen Computer gebunden ist.
[in] ulFlags
Vom Aufrufer bereitgestellte Flags, die angeben, wie die Aufzählung erfolgen soll. Dieser Parameter kann auf eine Kombination der folgenden Flags festgelegt werden, wie angegeben:
CM_REENUMERATE_ASYNCHRONOUS
Eine erneute Aufzählung sollte asynchron erfolgen. Der Aufruf dieser Funktion wird unmittelbar nach erhalt der Erneutumerierungsanforderung vom PnP-Manager zurückgegeben. Wenn dieses Kennzeichen festgelegt ist, sollte das CM_REENUMERATE_SYNCHRONOUS Flag nicht ebenfalls festgelegt werden.
CM_REENUMERATE_NORMAL
Gibt das Standardmäßige Reenumerationsverhalten an, bei dem die Aufzählung synchron erfolgt. Dieses Kennzeichen entspricht funktional CM_REENUMERATE_SYNCHRONOUS.
CM_REENUMERATE_RETRY_INSTALLATION
Gibt an, dass Plug and Play einen weiteren Versuch unternehmen soll, alle Geräte in der angegebenen Unterstruktur zu installieren, die erkannt, aber noch nicht konfiguriert wurden oder als erforderlich gekennzeichnet sind oder für die installation abgeschlossen werden muss. Diese Kennzeichnung kann zusammen mit der CM_REENUMERATE_SYNCHRONOUS-Kennzeichnung oder der CM_REENUMERATE_ASYNCHRONOUS-Kennzeichnung festgelegt werden.
Dieses Kennzeichen muss mit äußerster Vorsicht verwendet werden, da es dazu führen kann, dass der PnP-Manager den Benutzer auffordert, eine Installation dieser Geräte durchzuführen. Derzeit verwenden nur Komponenten wie Geräte-Manager und Hardware-Assistent dieses Flag, damit der Benutzer die Installation von Geräten wiederholen kann, die möglicherweise bereits erkannt wurden, aber derzeit nicht installiert sind.
CM_REENUMERATE_SYNCHRONOUS
Die Aufzählung sollte synchron erfolgen. Der Aufruf dieser Funktion gibt zurück, wenn alle Geräte in der Unterstruktur des angegebenen Geräts erneut Aufzählungsanforderungen gesendet wurden und diese Anforderungen vom Gerätestapel abgeschlossen wurden. Dies garantiert nicht, dass die Treiber in den Gerätestapeln dieser Geräte ihren Bus neu gescannt und Updates gemeldet haben. Außerdem wird nicht garantiert, dass alle gemeldeten neuen Geräte im Zustand "Gestartet" angezeigt werden. Wenn dieses Kennzeichen festgelegt ist, sollte das CM_REENUMERATE_ASYNCHRONOUS Flag nicht ebenfalls festgelegt werden. Dieses Kennzeichen entspricht funktionell CM_REENUMERATE_NORMAL.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird eine der CR_-präfixierten Fehlercodes zurückgegeben, die in Cfgmgr32.hdefiniert sind.
Bemerkungen
Wenn der angegebene Geräteknoten ein Hardware- oder Softwarebusgerät darstellt, fragt der PnP-Manager die Gerätetreiber nach einer Liste untergeordneter Elemente ab, versucht dann, untergeordnete Geräte zu konfigurieren und zu starten, die zuvor nicht konfiguriert waren. Der PnP-Manager initiiert auch das Entfernen von Geräten, die nicht mehr vorhanden sind (siehe IRP_MN_SURPRISE_REMOVAL). Treiber können sich jedoch entscheiden, die Busbeziehungen zu aktualisieren, die sie dem PnP-Manager asynchron von der Erneutumerationsanforderung melden, sodass das Erscheinungsbild neuer Geräte und das Entfernen von Geräten, die nicht mehr vorhanden sind, möglicherweise nicht abgeschlossen sind, wenn der Erneuten Aufzählungsvorgang abgeschlossen ist.
Aufrufer dieser Funktion müssen Über SeLoadDriverPrivilege verfügen. (Berechtigungen werden in der Microsoft Windows SDK-Dokumentation beschrieben.)
Informationen zur Verwendung von Geräteinstanzhandles, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.
Anforderungen
Anforderung | Wert |
---|---|
Mindestens unterstützter Client | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
Zielplattform | Arbeitsfläche |
Überschrift | cfgmgr32.h (enthalten Cfgmgr32.h) |
Bibliothek | Cfgmgr32.lib |
DLL | Cfgmgr32.dll |