Fonction WdfFdoGetDefaultChildList (wdffdo.h)

  • Article

[S’applique uniquement à KMDF]

La méthode WdfFdoGetDefaultChildList retourne un handle à la liste enfant par défaut d’un appareil spécifié.

Syntaxe

WDFCHILDLIST WdfFdoGetDefaultChildList(
  [in] WDFDEVICE Fdo
);

Paramètres

[in] Fdo

Handle d’un objet d’appareil framework.

Valeur retournée

Si l’opération réussit, WdfFdoGetDefaultChildList retourne un handle à la liste enfant par défaut associée à l’appareil spécifié par Fdo. Sinon, la méthode retourne NULL.

Un bogue système case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Avant d’appeler WdfFdoGetDefaultChildList, votre pilote doit appeler WdfFdoInitSetDefaultChildListConfig pour configurer la liste enfant par défaut. Sinon, WdfFdoGetDefaultChildList retourne NULL.

Pour plus d’informations sur les listes enfants, consultez Énumération dynamique.

Exemples

L’exemple de code suivant obtient un handle pour la liste enfant par défaut d’un appareil.

WDFCHILDLIST  list;

list = WdfFdoGetDefaultChildList(Device);

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdffdo.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

WdfFdoInitSetDefaultChildListConfig