WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 结构 (wdfchildlist.h)

[仅适用于 KMDF]

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 结构是标头结构,必须是每个地址说明结构的第一个成员。

语法

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

成员

AddressDescriptionSize

包含设备地址信息的驱动程序定义结构的大小(以字节为单位)。

注解

若要初始化 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 结构,驱动程序应调用 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

驱动程序为 AddressDescriptionSize 成员指定的值必须与它在WDF_CHILD_LIST_CONFIG结构中为 AddressDescriptionSize 成员指定的值匹配。

地址描述结构是驱动程序定义的。 驱动程序必须将结构的大小存储在 AddressDescriptionSize 成员中。 size 值必须包括此标头结构的大小。 例如,驱动程序可以定义地址描述符,如下所示:

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;

若要为此地址描述符设置 AddressDescriptionSize 成员,驱动程序可以使用以下代码:

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

有关地址说明的详细信息,请参阅 动态枚举

要求

要求
最低 KMDF 版本 1.0
标头 wdfchildlist.h (包括 Wdf.h)

另请参阅

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_CONFIG