Partager via


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

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo