структура 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.
Значение, указанное драйвером для элемента IdentificationDescriptionSizeSize, должно соответствовать значению, заданному для элемента IdentificationDescriptionSize в структуре WDF_CHILD_LIST_CONFIG.
Структуры описания идентификации определяются драйвером. Драйвер должен хранить размер структуры в элементе 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