WdfChildListRequestChildEject, fonction (wdfchildlist.h)

  • Article

[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)

Voir aussi

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfPdoRequestEject