structure WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER (wdfchildlist.h)

  • Article

[S’applique à KMDF uniquement]

La structure WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER est une structure d’en-tête qui doit être le premier membre de chaque structure de description d’identification .

Syntaxe

typedef struct _WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER {
  ULONG IdentificationDescriptionSize;
} WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER, *PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER;

Membres

IdentificationDescriptionSize

Taille, en octets, d’une structure définie par le pilote qui contient des informations d’identification de périphérique.

Remarques

Pour initialiser une structure WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER , votre pilote doit appeler WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT.

La valeur que le pilote spécifie pour le membre IdentificationDescriptionSize doit correspondre à la valeur qu’il spécifie pour le membre IdentificationDescriptionSize dans sa structure WDF_CHILD_LIST_CONFIG .

Les structures de description d’identification sont définies par le pilote. Le pilote doit stocker la taille de la structure dans le membre IdentificationDescriptionSize . La valeur size doit inclure la taille de cette structure d’en-tête. Par exemple, un pilote peut définir un descripteur d’identification comme suit :

typedef struct _IEEE_1394_CHILD_ID_DESCRIPTION {
  WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER  IdHeader;
 WCHAR  VendorName[32];
 WCHAR  ModelName[32];
 LONG  UnitSpecId; 
 LONG  UnitSoftwareVersion;
} IEEE_1394_CHILD_ID_DESCRIPTION, *PIEEE_1394_CHILD_ID_DESCRIPTION;

Pour définir le membre IdentificationDescriptionSize pour ce descripteur d’adresse, le pilote peut utiliser le code suivant :

IEEE_1394_CHILD_ID_DESCRIPTION ID_Description;
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(&ID_Description,
                                                 sizeof(ID_Description));

Pour plus d’informations sur les descriptions d’identification, 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_INIT

WDF_CHILD_LIST_CONFIG