Función WdfFdoGetDefaultChildList (wdffdo.h)

  • Artículo

[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