estructura WDF_CHILD_ADDRESS_DESCRIPTION_HEADER (wdfchildlist.h)

Artículo
08/08/2023

[Solo se aplica a KMDF]

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

Sintaxis

typedef struct _WDF_CHILD_ADDRESS_DESCRIPTION_HEADER {
  ULONG AddressDescriptionSize;
} WDF_CHILD_ADDRESS_DESCRIPTION_HEADER, *PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER;

Miembros

AddressDescriptionSize

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

Comentarios

Para inicializar una estructura de WDF_CHILD_ADDRESS_DESCRIPTION_HEADER , el controlador debe llamar a WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT.

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

Las estructuras de descripción de direcciones están definidas por el controlador. El controlador debe almacenar el tamaño de la estructura en el miembro AddressDescriptionSize . 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 dirección de la siguiente manera:

typedef struct _IEEE_1394_CHILD_ADDRESS_DESCRIPTION {
  WDF_CHILD_ADDRESS_DESCRIPTION_HEADER  AddressHeader;
  //
  // Current bus generation
  //
  ULONG Generation;
} IEEE_1394_CHILD_ADDRESS_DESCRIPTION, *PIEEE_1394_CHILD_ADDRESS_DESCRIPTION;

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

IEEE_1394_CHILD_ADDRESS_DESCRIPTION Addr_Description;
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT (&Addr_Description, 
                                           sizeof(Addr_Description));

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