WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 结构 (wdfchildlist.h)

  • 项目

[仅适用于 KMDF]

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 结构是标头结构，必须是每个标识说明结构的第一个成员。

语法

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

成员

IdentificationDescriptionSize

包含设备标识信息的驱动程序定义结构的大小（以字节为单位）。

注解

若要初始化 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 结构，驱动程序应调用 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT。

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

标识说明结构由驱动程序定义。 驱动程序必须将结构的大小存储在 IdentificationDescriptionSize 成员中。 size 值必须包括此标头结构的大小。 例如，驱动程序可以定义标识描述符，如下所示：

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;

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

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

有关标识说明的详细信息，请参阅 动态枚举。

要求

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

另请参阅

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG