структура 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 , должно совпадать со значением, указанным для элемента IdentificationDescriptionSize в его WDF_CHILD_LIST_CONFIG структуре.

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

Дополнительные сведения об описаниях идентификации см. в разделе Динамическое перечисление.

Требования

См. также раздел

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG