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 función de devolución de llamada WdfChildListRetrieveNextDevic e y proporciona un EvtChildListIdentificationDescriptionCompare función de devolución de llamada, el controlador también debe proporcionar una descripción de identificación que la función de devolución de llamada puede usar para comparar con una entrada en 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 de tipo WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUSque proporciona el marco de trabajo.
EvtChildListIdentificationDescriptionCompare
Puntero proporcionado por el controlador a una función de devolución de llamada EvtChildListIdentificationDescriptionCompa re.
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.
Observaciones
La estructura WDF_CHILD_RETRIEVE_INFO se pasa al WdfChildListRetrieveNextDevice y métodos de WdfChildListRetrievePdo.
Para inicializar una estructura de WDF_CHILD_RETRIEVE_INFO, el controlador debe llamar a WDF_CHILD_RETRIEVE_INFO_INIT.
Requisitos
| Requisito | Valor |
|---|---|
| versión mínima de KMDF | 1.0 |
| encabezado de | 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