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

Статья
02/07/2025

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

Структура WDF_CHILD_RETRIEVE_INFO содержит сведения о дочернем устройстве, полученном путем вызова WdfChildListRetrieveNextDevice или WdfChildListRetrievePdo.

Синтаксис

typedef struct _WDF_CHILD_RETRIEVE_INFO {
  ULONG                                                 Size;
  PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER          IdentificationDescription;
  PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER                 AddressDescription;
  WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS                 Status;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE EvtChildListIdentificationDescriptionCompare;
} WDF_CHILD_RETRIEVE_INFO, *PWDF_CHILD_RETRIEVE_INFO;

Члены

Size

Размер этой структуры в байтах.

IdentificationDescription

Указатель на структуру, выделенную драйвером WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER. Драйвер должен указать значение для элемента IdentificationDescriptionSize структуры.

Если драйвер вызывает WdfChildListRetrieveNextDevice и предоставляет EvtChildListIdentificationDescriptionCompare функцию обратного вызова, драйвер также должен предоставить описание идентификации, что функция обратного вызова может использовать для сравнения с записью в дочернем списке.

Если драйвер вызывает WdfChildListRetrievePdo, драйвер должен заполнить полное описание идентификации.

AddressDescription

Указатель на структуру, выделенную драйвером WDF_CHILD_ADDRESS_DESCRIPTION_HEADER. Драйвер должен указать значение для элемента AddressDescriptionSize этой структуры. Платформа заполняет остальную часть описания адреса при получении дочернего элемента из дочернего списка. Если значение AddressDescriptionSize равно NULL, сведения об описании адреса не извлекаются.

Status

WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUSтипизированное значение, которое предоставляет платформа.

EvtChildListIdentificationDescriptionCompare

Указатель драйвера на функцию обратного вызова EvtChildListIdentificationDescriptionCompare.

Если драйвер вызывает WdfChildListRetrieveNextDevice, этот указатель необязателен и может быть NULL.

Если драйвер вызывает WdfChildListRetrievePdo, этот указатель не используется.

Замечания

Структура WDF_CHILD_RETRIEVE_INFO передается методам WdfChildListRetrieveNextDev ice и WdfChildListRetrievePdo.

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

Требования

Требование	Ценность
минимальная версия KMDF	1.0
заголовка	wdfchildlist.h (включая Wdf.h)

См. также

EvtChildListIdentificationDescriptionCompare

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo

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