WDF_CHILD_LIST_CONFIG structure (wdfchildlist.h)

Article
08/08/2023

[S’applique à KMDF uniquement]

La structure WDF_CHILD_LIST_CONFIG contient des informations de configuration pour une liste d’appareils enfants.

Syntaxe

typedef struct _WDF_CHILD_LIST_CONFIG {
  ULONG                                                   Size;
  ULONG                                                   IdentificationDescriptionSize;
  ULONG                                                   AddressDescriptionSize;
  PFN_WDF_CHILD_LIST_CREATE_DEVICE                        EvtChildListCreateDevice;
  PFN_WDF_CHILD_LIST_SCAN_FOR_CHILDREN                    EvtChildListScanForChildren;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY      EvtChildListIdentificationDescriptionCopy;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_DUPLICATE EvtChildListIdentificationDescriptionDuplicate;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP   EvtChildListIdentificationDescriptionCleanup;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE   EvtChildListIdentificationDescriptionCompare;
  PFN_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_COPY             EvtChildListAddressDescriptionCopy;
  PFN_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_DUPLICATE        EvtChildListAddressDescriptionDuplicate;
  PFN_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP          EvtChildListAddressDescriptionCleanup;
  PFN_WDF_CHILD_LIST_DEVICE_REENUMERATED                  EvtChildListDeviceReenumerated;
} WDF_CHILD_LIST_CONFIG, *PWDF_CHILD_LIST_CONFIG;

Membres

Size

Taille, en octets, de cette structure.

IdentificationDescriptionSize

Taille, en octets, de la description d’identification de chaque enfant. Pour plus d’informations, consultez WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER.

AddressDescriptionSize

Taille, en octets, de la description de l’adresse de chaque enfant. Pour plus d’informations, consultez WDF_CHILD_ADDRESS_DESCRIPTION_HEADER.

EvtChildListCreateDevice

Pointeur vers la fonction de rappel d’événement EvtChildListCreateDevice du pilote. Cette fonction de rappel est obligatoire.

EvtChildListScanForChildren

Pointeur vers la fonction de rappel d’événement EvtChildListScanForChildren du pilote. Cette fonction de rappel est facultative.

EvtChildListIdentificationDescriptionCopy

Pointeur vers la fonction de rappel d’événement EvtChildListIdentificationDescriptionCopy du pilote. Cette fonction de rappel est facultative.

EvtChildListIdentificationDescriptionDuplicate

Pointeur vers la fonction de rappel d’événement EvtChildListIdentificationDescriptionDuplicate du pilote. Cette fonction de rappel est facultative.

EvtChildListIdentificationDescriptionCleanup

Pointeur vers la fonction de rappel d’événement EvtChildListIdentificationDescriptionCleanup du pilote. Cette fonction de rappel est facultative.

EvtChildListIdentificationDescriptionCompare

Pointeur vers la fonction de rappel d’événement EvtChildListIdentificationDescriptionCompare du pilote. Cette fonction de rappel est facultative.

EvtChildListAddressDescriptionCopy

Pointeur vers la fonction de rappel d’événement EvtChildListAddressDescriptionCopy du pilote. Cette fonction de rappel est facultative.

EvtChildListAddressDescriptionDuplicate

Pointeur vers la fonction de rappel d’événement EvtChildListAddressDescriptionDuplicate du pilote. Cette fonction de rappel est facultative.

EvtChildListAddressDescriptionCleanup

Pointeur vers la fonction de rappel d’événement EvtChildListAddressDescriptionCleanup du pilote. Cette fonction de rappel est facultative.

EvtChildListDeviceReenumerated

Pointeur vers la fonction de rappel d’événement EvtChildListDeviceReenumerated du pilote. Cette fonction de rappel est facultative.

Remarques

La structure WDF_CHILD_LIST_CONFIG est utilisée comme entrée pour les méthodes WdfFdoInitSetDefaultChildListConfig et WdfChildListCreate .

Pour initialiser une structure WDF_CHILD_LIST_CONFIG, le pilote doit appeler WDF_CHILD_LIST_CONFIG_INIT.

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

Configuration requise

Condition requise	Valeur
Version KMDF minimale	1.0
En-tête	wdfchildlist.h (inclure Wdf.h)

Voir aussi

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate

WdfFdoInitSetDefaultChildListConfig

Partager via