WdfFdoInitSetDefaultChildListConfig, fonction (wdffdo.h)

Article
02/27/2024

[S’applique à KMDF uniquement]

La méthode WdfFdoInitSetDefaultChildListConfig configure la liste enfant par défaut d’un pilote de bus.

Syntaxe

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

Paramètres

[in, out] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT que le pilote a obtenue à partir de sa fonction de rappel EvtDriverDeviceAdd .

[in] Config

Pointeur vers une structure de WDF_CHILD_LIST_CONFIG allouée par le pilote.

[in, optional] DefaultChildListAttributes

Pointeur vers une structure de WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui contient des attributs d’objet pour l’objet de liste enfant qui représente la liste enfant par défaut du pilote. Ce paramètre est facultatif et peut être WDF_NO_OBJECT_ATTRIBUTES.

Valeur de retour

None

Remarques

Un pilote de bus doit appeler WdfFdoInitSetDefaultChildListConfig avant d’appeler WdfDeviceCreate pour l’objet d’appareil fonctionnel (FDO). Pour plus d’informations sur l’appel de WdfDeviceCreate, consultez Création d’un objet d’appareil framework.

Pour plus d’informations sur la méthode WdfFdoInitSetDefaultChildListConfig , consultez Énumération des appareils sur un bus.

Exemples

L’exemple de code suivant initialise une structure WDF_CHILD_LIST_CONFIG , puis appelle 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
                                    );

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdffdo.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	ChildListConfiguration(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate

Partager via