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

Статья
08/08/2023

[Относится только к 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, этот указатель не используется.