WdfFdoInitSetEventCallbacks-Funktion (wdffdo.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfFdoInitSetEventCallbacks-Methode registriert die Ereignisrückruffunktionen eines frameworkbasierten Funktionstreibers für ein angegebenes Gerät.

Syntax

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

Parameter

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT Struktur, die der Treiber aus seiner Rückruffunktion EvtDriverDeviceAdd abgerufen hat.

[in] FdoEventCallbacks

Ein Zeiger auf eine vom Treiber zugewiesene WDF_FDO_EVENT_CALLBACKS Struktur.

Rückgabewert

Keine

Bemerkungen

Vor dem Aufrufen von WdfFdoInitSetEventCallbacks muss der Treiber eine WDF_FDO_EVENT_CALLBACKS Struktur zuordnen und die Struktur mit Zeigern auf die Ereignisrückruffunktionen des Treibers ausfüllen.

Der Treiber muss WdfFdoInitSetEventCallbacks aufrufen, bevor WdfDeviceCreate aufgerufen wird. Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.

Weitere Informationen zur WdfFdoInitSetEventCallbacks-Methode finden Sie unter Erstellen von Geräteobjekten in einem Funktionstreiber.

Beispiele

Im folgenden Codebeispiel wird eine WDF_FDO_EVENT_CALLBACKS-Struktur initialisiert und dann WdfFdoInitSetEventCallbacks aufgerufen.

WDF_FDO_EVENT_CALLBACKS fdoCallbacks;

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

WdfFdoInitSetEventCallbacks(
                            DeviceInit,
                            &fdoCallbacks
                            );

Anforderungen

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

Weitere Informationen

WDF_FDO_EVENT_CALLBACKS_INIT