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 成员中。 大小值必须包含此标头结构的大小。 例如,驱动程序可以定义标识描述符,如下所示:

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