Fonction WdfPdoInitSetEventCallbacks (wdfpdo.h)

  • Article

[S’applique uniquement à KMDF]

La méthode WdfPdoInitSetEventCallbacks enregistre les fonctions de rappel d’événements d’un pilote de bus.

Syntaxe

void WdfPdoInitSetEventCallbacks(
  [in] PWDFDEVICE_INIT          DeviceInit,
  [in] PWDF_PDO_EVENT_CALLBACKS DispatchTable
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT .

[in] DispatchTable

Pointeur vers une structure de WDF_PDO_EVENT_CALLBACKS allouée par l’appelant.

Valeur de retour

None

Remarques

Le pilote de bus doit allouer une structure WDF_PDO_EVENT_CALLBACKS et remplir la structure avec des pointeurs vers les fonctions de rappel d’événements du pilote.

Le pilote doit appeler WdfPdoInitSetEventCallbacks avant d’appeler WdfDeviceCreate. Pour plus d’informations sur l’appel de WdfPdoInitSetEventCallbacks et WdfDeviceCreate, consultez Création d’objets d’appareil dans un pilote de bus.

Exemples

L’exemple de code suivant initialise une structure WDF_PDO_EVENT_CALLBACKS , puis appelle WdfPdoInitSetEventCallbacks.

PWDFDEVICE_INIT  pDeviceInit = NULL;
WDF_PDO_EVENT_CALLBACKS  pdoCallbacks;

pDeviceInit = WdfPdoInitAllocate(Device);
WDF_PDO_EVENT_CALLBACKS_INIT(&pdoCallbacks);
pdoCallbacks.EvtDeviceResourceRequirementsQuery = Bus_Pdo_EvtDeviceResourceRequirementsQuery;
WdfPdoInitSetEventCallbacks(
                            pDeviceInit,
                            &pdoCallbacks
                            );

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfpdo.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 ChildDeviceInitAPI(kmdf),DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Voir aussi

WDF_PDO_EVENT_CALLBACKS_INIT

WdfPdoInitAllocate