WdfPdoInitSetEventCallbacks-Funktion (wdfpdo.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die WdfPdoInitSetEventCallbacks-Methode registriert die Ereignisrückruffunktionen eines Bustreibers.

Syntax

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

Parameter

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT-Struktur .

[in] DispatchTable

Ein Zeiger auf eine aufruferseitig zugeordnete WDF_PDO_EVENT_CALLBACKS-Struktur .

Rückgabewert

Keine

Bemerkungen

Der Bustreiber muss eine WDF_PDO_EVENT_CALLBACKS Struktur zuordnen und die Struktur mit Zeigern auf die Ereignisrückruffunktionen des Treibers füllen.

Der Treiber muss WdfPdoInitSetEventCallbacks aufrufen, bevor WdfDeviceCreate aufgerufen wird. Weitere Informationen zum Aufrufen von WdfPdoInitSetEventCallbacks und WdfDeviceCreate finden Sie unter Erstellen von Geräteobjekten in einem Bustreiber.

Beispiele

Im folgenden Codebeispiel wird eine WDF_PDO_EVENT_CALLBACKS-Struktur initialisiert und dann WdfPdoInitSetEventCallbacks aufgerufen.

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

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
Kopfzeile	wdfpdo.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	ChildDeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Weitere Informationen

WDF_PDO_EVENT_CALLBACKS_INIT

WdfPdoInitAllocate

Freigeben über