Структура WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER (вдфчилдлист. h)

[Применяется только к КМДФ]

Структура 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

Размер (в байтах) структуры, определенной драйвером, которая содержит сведения об идентификации устройства.

Remarks

Чтобы инициализировать структуру WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER , драйвер должен вызвать WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT.

Значение, которое драйвер указывает для элемента идентификатиондескриптионсизе , должно соответствовать значению, указанному для элемента идентификатиондескриптионсизе в его структуре WDF_CHILD_LIST_CONFIG .

Структуры описания идентификации определяются драйвером. Драйвер должен хранить размер структуры в элементе идентификатиондескриптионсизе . Значение размера должно включать размер этой структуры заголовка. Например, драйвер может определить дескриптор идентификации следующим образом:

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;

Чтобы задать элемент идентификатиондескриптионсизе для этого дескриптора адресов, драйвер может использовать следующий код:

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

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

Требования

   
Минимальная версия КМДФ 1.0
Header вдфчилдлист. h (включение ВДФ. h)

См. также

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_CONFIG