Поделиться через


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

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

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

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