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
| Requisito | Value |
|---|---|
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfchildlist.h (incluya Wdf.h) |
Consulte también
EvtChildListIdentificationDescriptionCompare
WDF_CHILD_ADDRESS_DESCRIPTION_HEADER
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER
WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS