structure WDF_CHILD_RETRIEVE_INFO (wdfchildlist.h)
[S’applique uniquement à KMDF]
La structure WDF_CHILD_RETRIEVE_INFO contient des informations sur un appareil enfant obtenues en appelant WdfChildListRetrieveNextDevice ou WdfChildListRetrievePdo.
Syntaxe
typedef struct _WDF_CHILD_RETRIEVE_INFO {
ULONG Size;
PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription;
PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription;
WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS Status;
PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE EvtChildListIdentificationDescriptionCompare;
} WDF_CHILD_RETRIEVE_INFO, *PWDF_CHILD_RETRIEVE_INFO;
Membres
Size
Taille, en octets, de cette structure.
IdentificationDescription
Pointeur vers une structure de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER allouée par le pilote. Le pilote doit fournir une valeur pour le membre IdentificationDescriptionSize de cette structure.
Si le pilote appelle WdfChildListRetrieveNextDevice et fournit une fonction de rappel EvtChildListIdentificationDescriptionCompare , le pilote doit également fournir une description d’identification que la fonction de rappel peut utiliser pour comparer avec une entrée dans une liste enfant.
Si le pilote appelle WdfChildListRetrievePdo, il doit remplir la description d’identification complète.
AddressDescription
Pointeur vers une structure de WDF_CHILD_ADDRESS_DESCRIPTION_HEADER allouée par le pilote. Le pilote doit fournir une valeur pour le membre AddressDescriptionSize de cette structure. L’infrastructure remplit le reste de la description de l’adresse lorsqu’il récupère un enfant de la liste enfant. Si la valeur de AddressDescriptionSize est NULL, les informations de description d’adresse ne sont pas récupérées.
Status
Valeur de type WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS que l’infrastructure fournit.
EvtChildListIdentificationDescriptionCompare
Pointeur fourni par le pilote vers une fonction de rappel EvtChildListIdentificationDescriptionCompare .
Si le pilote appelle WdfChildListRetrieveNextDevice, ce pointeur est facultatif et peut être NULL.
Si le pilote appelle WdfChildListRetrievePdo, ce pointeur n’est pas utilisé.
Remarques
La structure WDF_CHILD_RETRIEVE_INFO est passée aux méthodes WdfChildListRetrieveNextDevice et WdfChildListRetrievePdo .
Pour initialiser une structure WDF_CHILD_RETRIEVE_INFO, le pilote doit appeler WDF_CHILD_RETRIEVE_INFO_INIT.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Version KMDF minimale | 1.0 |
| En-tête | wdfchildlist.h (inclure Wdf.h) |
Voir aussi
EvtChildListIdentificationDescriptionCompare
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER
WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS