estructura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER (wdfchildlist.h)

  • Artículo

[Solo se aplica a KMDF]

La estructura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER es una estructura de encabezado que debe ser el primer miembro de cada estructura de descripción de identificación .

Sintaxis

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

Miembros

IdentificationDescriptionSize

Tamaño, en bytes, de una estructura definida por el controlador que contiene información de identificación del dispositivo.

Comentarios

Para inicializar una estructura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER , el controlador debe llamar a WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT.

El valor que especifica el controlador para el miembro IdentificationDescriptionSize debe coincidir con el valor que especifica para el miembro IdentificationDescriptionSize en su estructura de WDF_CHILD_LIST_CONFIG .

Las estructuras de descripción de identificación están definidas por el controlador. El controlador debe almacenar el tamaño de la estructura en el miembro IdentificationDescriptionSize . El valor de tamaño debe incluir el tamaño de esta estructura de encabezado. Por ejemplo, un controlador podría definir un descriptor de identificación de la siguiente manera:

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;

Para establecer el miembro IdentificationDescriptionSize para este descriptor de dirección, el controlador puede usar el código siguiente:

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

Para obtener más información sobre las descripciones de identificación, vea Enumeración dinámica.

Requisitos

Requisito Value
Versión mínima de KMDF 1.0
Encabezado wdfchildlist.h (incluya Wdf.h)

Consulte también

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG