WdfFdoInitSetDefaultChildListConfig, fonction (wdffdo.h)

[S’applique uniquement à KMDF]

La méthode WdfFdoInitSetDefaultChildListConfig configure la liste enfant par défaut d’un pilote 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 WDF_CHILD_LIST_CONFIG allouée par le pilote.

[in, optional] DefaultChildListAttributes

Pointeur vers une structure 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

Aucun

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 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
                                    );

Spécifications

Voir aussi

WDF_CHILD_LIST_CONFIG_INIT

WdfChildListCreate