estructura WDF_CHILD_RETRIEVE_INFO (wdfchildlist.h)

[Solo se aplica a KMDF]

La estructura WDF_CHILD_RETRIEVE_INFO contiene información sobre un dispositivo secundario que se obtiene llamando a WdfChildListRetrieveNextDevice o WdfChildListRetrievePdo.

Sintaxis

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;

Miembros

Size

Tamaño, en bytes, de esta estructura.

IdentificationDescription

Puntero a una estructura de WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER asignada por el controlador. El controlador debe proporcionar un valor para el miembro IdentificationDescriptionSize de esta estructura.

Si el controlador llama a WdfChildListRetrieveNextDevice y proporciona una función de devolución de llamada EvtChildListIdentificationDescriptionCompare , el controlador también debe proporcionar una descripción de identificación que la función de devolución de llamada puede usar para compararla con una entrada de una lista secundaria.

Si el controlador llama a WdfChildListRetrievePdo, el controlador debe rellenar toda la descripción de identificación.

AddressDescription

Puntero a una estructura de WDF_CHILD_ADDRESS_DESCRIPTION_HEADER asignada por el controlador. El controlador debe proporcionar un valor para el miembro AddressDescriptionSize de esta estructura. El marco rellena el resto de la descripción de la dirección cuando recupera un elemento secundario de la lista secundaria. Si el valor de AddressDescriptionSize es NULL, no se recupera la información de descripción de la dirección.

Status

Valor WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS tipado que proporciona el marco de trabajo.

EvtChildListIdentificationDescriptionCompare

Puntero proporcionado por el controlador a una función de devolución de llamada EvtChildListIdentificationDescriptionCompare .

Si el controlador llama a WdfChildListRetrieveNextDevice, este puntero es opcional y puede ser NULL.

Si el controlador llama a WdfChildListRetrievePdo, este puntero no se usa.

Comentarios

La estructura WDF_CHILD_RETRIEVE_INFO se pasa a los métodos WdfChildListRetrieveNextDevice y WdfChildListRetrievePdo .

Para inicializar una estructura de WDF_CHILD_RETRIEVE_INFO, el controlador debe llamar a WDF_CHILD_RETRIEVE_INFO_INIT.

Requisitos

Consulte también

EvtChildListIdentificationDescriptionCompare

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo