структура WDF_CHILD_ADDRESS_DESCRIPTION_HEADER (wdfchildlist.h)

  • Статья

[Применяется только к KMDF]

Структура WDF_CHILD_ADDRESS_DESCRIPTION_HEADER — это структура заголовков, которая должна быть первым элементом каждой структуры описания адреса .

Синтаксис

typedef struct _WDF_CHILD_ADDRESS_DESCRIPTION_HEADER {
  ULONG AddressDescriptionSize;
} WDF_CHILD_ADDRESS_DESCRIPTION_HEADER, *PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER;

Члены

AddressDescriptionSize

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

Комментарии

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

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

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

typedef struct _IEEE_1394_CHILD_ADDRESS_DESCRIPTION {
  WDF_CHILD_ADDRESS_DESCRIPTION_HEADER  AddressHeader;
  //
  // Current bus generation
  //
  ULONG Generation;
} IEEE_1394_CHILD_ADDRESS_DESCRIPTION, *PIEEE_1394_CHILD_ADDRESS_DESCRIPTION;

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

IEEE_1394_CHILD_ADDRESS_DESCRIPTION Addr_Description;
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT (&Addr_Description, 
                                           sizeof(Addr_Description));

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

Требования

Требование Значение
Минимальная версия KMDF 1,0
Верхняя часть wdfchildlist.h (включая Wdf.h)

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

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_CONFIG