Partager via


WdfFdoGetDefaultChildList, fonction (wdffdo.h)

[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 vers un objet d’appareil framework.

Valeur de retour

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 .

Une vérification des bogues système 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 d’énumération dynamique .

Exemples

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

WDFCHILDLIST  list;

list = WdfFdoGetDefaultChildList(Device);

Spécifications

Besoin Valeur
plateforme cible Universel
version minimale de KMDF 1.0
En-tête wdffdo.h (include Wdf.h)
Bibliothèque Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL <= DISPATCH_LEVEL
règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfFdoInitSetDefaultChildListConfig