WdfFdoInitSetEventCallbacks, fonction (wdffdo.h)

  • Article

[S’applique uniquement à KMDF]

La méthode WdfFdoInitSetEventCallbacks enregistre les fonctions de rappel d’événements d’un pilote de fonction framework pour un appareil spécifié.

Syntaxe

void WdfFdoInitSetEventCallbacks(
  [in] PWDFDEVICE_INIT          DeviceInit,
  [in] PWDF_FDO_EVENT_CALLBACKS FdoEventCallbacks
);

Paramètres

[in] DeviceInit

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

[in] FdoEventCallbacks

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

Valeur de retour

None

Remarques

Avant d’appeler WdfFdoInitSetEventCallbacks, le pilote doit allouer une structure WDF_FDO_EVENT_CALLBACKS et remplir la structure avec des pointeurs vers les fonctions de rappel d’événements du pilote.

Le pilote doit appeler WdfFdoInitSetEventCallbacks avant d’appeler WdfDeviceCreate. 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 WdfFdoInitSetEventCallbacks , consultez Création d’objets d’appareil dans un pilote de fonction.

Exemples

L’exemple de code suivant initialise une structure WDF_FDO_EVENT_CALLBACKS, puis appelle WdfFdoInitSetEventCallbacks.

WDF_FDO_EVENT_CALLBACKS fdoCallbacks;

WDF_FDO_EVENT_CALLBACKS_INIT(&fdoCallbacks);
fdoCallbacks.EvtDeviceFilterAddResourceRequirements = MyEvtDeviceFilterAddResourceRequirements;
fdoCallbacks.EvtDeviceFilterRemoveResourceRequirements = MyEvtDeviceFilterRemoveResourceRequirements;
fdoCallbacks.EvtDeviceRemoveAddedResources = MyEvtDeviceRemoveAddedResources;

WdfFdoInitSetEventCallbacks(
                            DeviceInit,
                            &fdoCallbacks
                            );

Configuration requise

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

Voir aussi

WDF_FDO_EVENT_CALLBACKS_INIT