Compartir a través de


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.

Observaciones

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 Valor
de la plataforma de destino de Universal
versión mínima de KMDF 1.0
encabezado wdffdo.h (incluya Wdf.h)
Biblioteca 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