WdfChildListRequestChildEject, fonction (wdfchildlist.h)
[S’applique uniquement à KMDF]
La méthode WdfChildListRequestChildEject informe l’infrastructure qu’un appareil spécifié est sur le point d’être éjecté de sa station d’accueil.
Syntaxe
BOOLEAN WdfChildListRequestChildEject(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);
Paramètres
[in] ChildList
Handle d’un objet de liste enfant.
[in] IdentificationDescription
Pointeur vers une structure de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER allouée par l’appelant.
Valeur retournée
WdfChildListRequestChildEject retourne TRUE si l’opération réussit. Si un paramètre d’entrée n’est pas valide ou si l’infrastructure ne trouve pas l’appareil dans la liste enfant, la méthode retourne FALSE.
Un bogue système case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Un pilote de bus peut appeler WdfChildListRequestChildEject ou WdfPdoRequestEject pour signaler que le pilote a détecté une tentative d’éjection de l’un de ses appareils enfants énumérés à partir de la station d’accueil de l’appareil. Par exemple, le pilote peut détecter qu’un utilisateur a poussé un bouton d’éjection.
Si le pilote utilise l’énumération de bus dynamique et si la description d’identification de l’appareil est disponible, le pilote peut appeler WdfChildListRequestChildEject. Si l’objet d’appareil framework pour le PDO de l’appareil est disponible, le pilote peut appeler WdfPdoRequestEject.
Le paramètre IdentificationDescription de la méthode WdfChildRequestChildEject identifie l’appareil qui est éjecté. L’appareil doit être membre de la liste enfant que représente le paramètre ChildList .
L’infrastructure utilise la description d’identification pour localiser l’appareil dans la liste enfant.
Pour plus d’informations sur les listes enfants, consultez Énumération dynamique.
Pour plus d’informations sur les appareils éjectables, consultez Prise en charge des appareils éjectables.
Exemples
Pour obtenir un exemple de code qui utilise WdfChildListRequestChildEject, consultez WdfChildListRetrieveNextDevice.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfchildlist.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |