EVT_WDF_CHILD_LIST_CREATE_DEVICE función de devolución de llamada (wdfchildlist.h)
[Solo se aplica a KMDF]
La función de devolución de llamada de eventosEvtChildListCreateDevice del controlador de bus crea un objeto de dispositivo de marco para un nuevo dispositivo que se ha enumerado dinámicamente.
Sintaxis
EVT_WDF_CHILD_LIST_CREATE_DEVICE EvtWdfChildListCreateDevice;
NTSTATUS EvtWdfChildListCreateDevice(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription,
[in] PWDFDEVICE_INIT ChildInit
)
{...}
Parámetros
[in] ChildList
Identificador del objeto de lista secundaria del marco que especificó el controlador cuando llamó a WdfChildListAddOrUpdateChildDescriptionAsPresent.
[in] IdentificationDescription
Puntero a una copia de la estructura WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER que el controlador especificó cuando llamó a WdfChildListAddOrUpdateChildDescriptionAsPresent.
[in] ChildInit
Puntero a una estructura de WDFDEVICE_INIT .
Valor devuelto
La función de devolución de llamada EvtChildListCreateDevice debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE, si la operación se realiza correctamente. De lo contrario, esta función debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.
Si se produjo un error en la operación, pero cree que el controlador debe intentarlo más tarde y si la función de devolución de llamada EvtChildListCreateDevice del controlador no ha llamado a WdfDeviceCreate, el controlador puede devolver STATUS_RETRY. Como resultado, el marco llama a la función de devolución de llamada EvtChildListCreateDevice más tarde. Si el controlador devuelve STATUS_RETRY varias veces, el marco dejará de llamar a la función de devolución de llamada para el dispositivo con errores.
Comentarios
Si un controlador de bus usa la enumeración dinámica, puede registrar una función de devolución de llamada EvtChildListCreateDevice llamando a WdfFdoInitSetDefaultChildListConfig o WdfChildListCreate.
Después de que un controlador llame a WdfChildListAddOrUpdateChildDescriptionAsPresent o WdfChildListUpdateAllChildDescriptionsAsPresent, el marco llama a la función de devolución de llamada EvtChildListCreateDevice del controlador. La función de devolución de llamada debe llamar a WdfDeviceCreate para crear un objeto de dispositivo de marco (un PDO).
Antes de llamar a WdfDeviceCreate, el controlador debe llamar a funciones proporcionadas por el marco que inicializan la estructura de WDFDEVICE_INIT. Para obtener más información sobre estas funciones, consulte WDFDEVICE_INIT.
Para obtener más información sobre cómo llamar a WdfDeviceCreate, vea Creating a Framework Device Object.
Para obtener más información sobre la enumeración dinámica, vea Enumeración de los dispositivos en un bus.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfchildlist.h (incluya Wdf.h) |
| IRQL | PASSIVE_LEVEL |
Consulte también
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER
WdfChildListAddOrUpdateChildDescriptionAsPresent