structure WDF_CHILD_RETRIEVE_INFO (wdfchildlist.h)
[S’applique uniquement à KMDF]
La structure WDF_CHILD_RETRIEVE_INFO contient des informations sur un appareil enfant obtenu 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 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 EvtChildListIdentificationDescriptionCompare fonction de rappel, le pilote doit également fournir une description d’identification que la fonction de rappel peut utiliser pour comparer une entrée dans une liste enfant.
Si le pilote appelle WdfChildListRetrievePdo, le pilote doit renseigner toute la description de l’identification.
AddressDescription
Pointeur vers une structure 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 renseigne le reste de la description de l’adresse lorsqu’elle récupère un enfant dans la liste enfant. Si la valeur de AddressDescriptionSize est NULL, les informations de description de l’adresse ne sont pas récupérées.
Status
Valeur WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS-typée 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 transmise aux méthodes WdfChildListRetrieveNextDevice et WdfChildListRetrievePdo.
Pour initialiser une structure WDF_CHILD_RETRIEVE_INFO, le pilote doit appeler WDF_CHILD_RETRIEVE_INFO_INIT.
Exigences
| Exigence | Valeur |
|---|---|
| version minimale de KMDF | 1.0 |
| d’en-tête | wdfchildlist.h (include Wdf.h) |
Voir aussi
EvtChildListIdentificationDescriptionCompare
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER
WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS