Partager via


structure WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER (wdfchildlist.h)

[S’applique uniquement à KMDF]

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

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 spécifiée par le pilote pour le membre IdentificationDescriptionSize doit correspondre à la valeur spécifiée pour le membre IdentificationDescriptionSize dans sa structure WDF_CHILD_LIST_CONFIG.

Les structures de description de l’identification sont définies par le pilote. Le pilote doit stocker la taille de la structure dans le membre IdentificationDescriptionSize. La valeur de taille 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 d’énumération dynamique .

Exigences

Exigence Valeur
version minimale de KMDF 1.0
d’en-tête wdfchildlist.h (include Wdf.h)

Voir aussi

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG