fonction CM_Reenumerate_DevNode_Ex (cfgmgr32.h)

[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée. Utilisez CM_Reenumerate_DevNode à la place.]

La fonction CM_Reenumerate_DevNode_Ex énumère les appareils identifiés par un nœud d’appareil spécifié et tous ses enfants.

Syntaxe

CMAPI CONFIGRET CM_Reenumerate_DevNode_Ex(
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Paramètres

[in] dnDevInst

Handle d’instance d’appareil fourni par l’appelant lié au handle d’ordinateur fourni par hMachine.

[in] ulFlags

Indicateurs fournis par l’appelant qui spécifient la façon dont la réenumation doit se produire. Ce paramètre peut être défini sur une combinaison des indicateurs suivants, comme indiqué :

CM_REENUMERATE_ASYNCHRONOUS

La réenumation doit se produire de façon asynchrone. L’appel à cette fonction retourne immédiatement après que le gestionnaire PnP reçoit la demande de réenumation. Si cet indicateur est défini, l’indicateur CM_REENUMERATE_SYNCHRONOUS ne doit pas également être défini.

CM_REENUMERATE_NORMAL

Spécifie le comportement de réenumation par défaut, dans lequel la réenumation se produit de manière synchrone. Cet indicateur équivaut actuellement à CM_REENUMERATE_SYNCHRONOUS.

CM_REENUMERATE_RETRY_INSTALLATION

Spécifie que Plug-and-Play doit effectuer une autre tentative d’installation d’appareils dans la sous-arborescence spécifiée qui ont été détectés, mais qui ne sont pas encore configurés, ou sont marqués comme nécessitant une réinstallation, ou pour lesquels l’installation doit être terminée. Cet indicateur peut être défini avec l’indicateur CM_REENUMERATE_SYNCHRONOUS ou l’indicateur de CM_REENUMERATE_ASYNCHRONOUS.

Cet indicateur doit être utilisé avec une prudence extrême, car il peut entraîner l’invite de l’utilisateur à effectuer l’installation de tous ces appareils. Actuellement, seuls les composants tels que Device Manager et l’Assistant Matériel utilisent cet indicateur pour permettre à l’utilisateur de réessayer l’installation des appareils qui ont déjà été détectés, mais qui ne sont pas actuellement installés.

CM_REENUMERATE_SYNCHRONOUS

La réenumation doit se produire de façon synchrone. L’appel à cette fonction retourne lorsque tous les appareils de la sous-arborescence de l’appareil spécifié ont reçu des demandes de réenumation envoyées et que ces demandes ont été effectuées par la pile d’appareils. Cela ne garantit pas que les pilotes dans les piles d’appareils de ces appareils ont rescanné leur bus et signalé des mises à jour. Il ne garantit pas non plus que les nouveaux appareils signalés sont dans l’état démarré. Si cet indicateur est défini, l’indicateur CM_REENUMERATE_ASYNCHRONOUS ne doit pas également être défini. Cet indicateur est fonctionnellement équivalent à CM_REENUMERATE_NORMAL.

[in, optional] hMachine

Handle d’ordinateur fourni par l’appelant auquel le handle d’instance d’appareil fourni par l’appelant est lié.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, elle retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.

Remarques

Si le nœud d’appareil spécifié représente un périphérique de bus matériel ou logiciel, le gestionnaire PnP interroge les pilotes de l’appareil pour obtenir une liste d’enfants, puis tente de configurer et de démarrer les appareils enfants qui n’ont pas été précédemment configurés. Le gestionnaire PnP lance également la suppression surprise des appareils qui ne sont plus présents (voir IRP_MN_SURPRISE_REMOVAL). Toutefois, les pilotes peuvent choisir de mettre à jour les relations de bus qu’ils signalent au gestionnaire PnP asynchrone de la demande de réenumation, de sorte que l’apparence des nouveaux appareils et la suppression des appareils qui ne sont plus présents peuvent ne pas être terminés lorsque l’opération de réenumation se termine.

Les appelants de cette fonction doivent avoir SeLoadDriverPrivilege. (Les privilèges sont décrits dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows.)

Pour plus d’informations sur l’utilisation de handles d’instance d’appareil liés à un ordinateur local ou distant, consultez CM_Get_Child_Ex.

La fonctionnalité d’accès aux machines distantes a été supprimée dans Windows 8 et Windows Server 2012 et versions ultérieures, vous ne pouvez donc pas accéder aux ordinateurs distants lors de l’exécution sur ces versions de Windows.

Spécifications

Voir aussi

CM_Get_Child_Ex

CM_Reenumerate_DevNode