Función WdfFdoGetDefaultChildList (wdffdo.h)
[Solo se aplica a KMDF]
El método WdfFdoGetDefaultChildList devuelve un identificador a la lista secundaria predeterminada de un dispositivo especificado.
Sintaxis
WDFCHILDLIST WdfFdoGetDefaultChildList(
[in] WDFDEVICE Fdo
);
Parámetros
[in] Fdo
Identificador de un objeto de dispositivo de marco.
Valor devuelto
Si la operación se realiza correctamente, WdfFdoGetDefaultChildList devuelve un identificador a la lista secundaria predeterminada asociada al dispositivo especificado por Fdo. De lo contrario, el método devuelve NULL.
Se produce una comprobación de errores del sistema si el controlador proporciona un identificador de objeto no válido.
Comentarios
Antes de llamar a WdfFdoGetDefaultChildList, el controlador debe llamar a WdfFdoInitSetDefaultChildListConfig para configurar la lista secundaria predeterminada. De lo contrario, WdfFdoGetDefaultChildList devuelve NULL.
Para obtener más información sobre las listas secundarias, vea Enumeración dinámica.
Ejemplos
En el ejemplo de código siguiente se obtiene un identificador de la lista secundaria predeterminada de un dispositivo.
WDFCHILDLIST list;
list = WdfFdoGetDefaultChildList(Device);
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdffdo.h (incluya Wdf.h) |
| Library | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| IRQL | <= DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |