Función WdfFdoInitSetDefaultChildListConfig (wdffdo.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfFdoInitSetDefaultChildListConfig configura la lista secundaria predeterminada del controlador de bus.

Sintaxis

void WdfFdoInitSetDefaultChildListConfig(
  [in, out]      PWDFDEVICE_INIT        DeviceInit,
  [in]           PWDF_CHILD_LIST_CONFIG Config,
  [in, optional] PWDF_OBJECT_ATTRIBUTES DefaultChildListAttributes
);

Parámetros

[in, out] DeviceInit

Puntero a una estructura WDFDEVICE_INIT que el controlador obtuvo de su función de devolución de llamada EvtDriverDeviceAdd .

[in] Config

Puntero a una estructura de WDF_CHILD_LIST_CONFIG asignada por el controlador.

[in, optional] DefaultChildListAttributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada que contiene atributos de objeto para el objeto child-list que representa la lista secundaria predeterminada del controlador. Este parámetro es opcional y puede ser WDF_NO_OBJECT_ATTRIBUTES.

Valor devuelto

None

Observaciones

Un controlador de bus debe llamar a WdfFdoInitSetDefaultChildListConfig antes de llamar a WdfDeviceCreate para el objeto de dispositivo funcional (FDO). 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 el método WdfFdoInitSetDefaultChildListConfig , vea Enumerar los dispositivos en un bus.

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de WDF_CHILD_LIST_CONFIG y, a continuación, se llama a WdfFdoInitSetDefaultChildListConfig.

WDF_CHILD_LIST_CONFIG  config;

WDF_CHILD_LIST_CONFIG_INIT(
                           &config,
 sizeof(MY_IDENTIFICATION_DESCRIPTION),
                           My_EvtDeviceListCreatePdo
                           );
config.EvtChildListIdentificationDescriptionDuplicate = My_EvtChildListIdentificationDescriptionDuplicate;
config.EvtChildListIdentificationDescriptionCompare = My_EvtChildListIdentificationDescriptionCompare;
config.EvtChildListIdentificationDescriptionCleanup = My_EvtChildListIdentificationDescriptionCleanup;

WdfFdoInitSetDefaultChildListConfig(
                                    DeviceInit,
                                    &config,
                                    WDF_NO_OBJECT_ATTRIBUTES
                                    );

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdffdo.h (incluir Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI ChildListConfiguration(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate