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)

Consulte también

WdfFdoInitSetDefaultChildListConfig