EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN fonction de rappel (wdfchildlist.h)

Article
02/29/2024

[S’applique uniquement à KMDF]

La fonction de rappel d’événement EvtChildListScanForChildren d’un pilote doit signaler tous les appareils enfants présents.

Syntaxe

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

void EvtWdfChildListScanForChildren(
  [in] WDFCHILDLIST ChildList
)
{...}

Paramètres

[in] ChildList

Handle d’un objet de liste enfant de framework.

Valeur de retour

None

Remarques

Si un pilote de bus utilise une énumération dynamique, il peut inscrire une fonction de rappel EvtChildListScanForChildren en appelant WdfFdoInitSetDefaultChildListConfig ou WdfChildListCreate.

Si un pilote fournit une fonction de rappel EvtChildListScanForChildren , l’infrastructure l’appelle chaque fois que l’appareil parent entre dans son état de travail (D0). (Pour plus d’informations sur l’appel de cette fonction de rappel, consultez Scénarios pnP et de gestion de l’alimentation.)

Le pilote doit signaler tous ses appareils enfants en procédant comme suit :

Appel de WdfChildListBeginScan, qui marque tous les appareils enfants précédemment signalés comme manquants.
Détection d’appareils enfants et appel de WdfChildListAddOrUpdateChildDescriptionAsPresent pour chaque appareil détecté.
Appel de WdfChildListEndScan, qui informe le gestionnaire PnP des appareils enfants signalés.

Pour plus d’informations sur l’énumération dynamique, consultez Énumération des appareils sur un bus.

La fonction de rappel EvtChildListScanForChildren est appelée à l’adresse IRQL = PASSIVE_LEVEL. Vous ne devez pas rendre cette fonction de rappel paginable.