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