Erstellen von Rückrufobjekten

Warnung

UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden.

Die archivierten UMDF 1-Beispiele finden Sie im Windows 11, Version 22H2 – Mai 2022 Treiberbeispiele Update.

Weitere Informationen finden Sie unter Erste Schritte mit UMDF.

Ein UMDF-Treiber kann Rückrufobjekte erstellen, die aus Kontextdaten und Schnittstellenmethoden bestehen. Das Framework greift über die Rückrufschnittstellenmethoden des Treibers auf die Rückrufobjekte des Treibers zu.

Die folgende Abbildung zeigt, wie vom Treiber implementierte Rückrufobjekte Frameworkobjekten entsprechen.

Frameworkobjekte und vom Anbieter bereitgestellte Rückrufobjekte.

Ein UMDF-Treiber kann verschiedene Arten von Rückrufobjekten erstellen, einschließlich der folgenden:

  • Treiberrückrufobjekt

    Das Framework verwendet das Treiberrückrufobjekt, um den Treiber zu initialisieren und den Treiber über die Ankunft eines neuen Geräts zu benachrichtigen.

  • Geräterückrufobjekt

    Der Treiber verwendet das Geräterückrufobjekt, um den Gerätekontext zu speichern und das Bereinigen und Schließen von Dateiobjekten und Plug & Play (PnP) und Energieverwaltungsereignissen (PM) zu verarbeiten.

  • Warteschlangenrückrufobjekt

    Der Treiber verwendet das Warteschlangenrückrufobjekt, um E/A zu verarbeiten.

Die folgende Abbildung zeigt, wie ein UMDF-Treiber ein Geräterückrufobjekt erstellt.

Aufrufsequenz zum Erstellen eines Umdf-Geräterückrufobjekts.

Die folgenden Themen enthalten Codebeispiele, die zeigen, wie ein Rückrufobjekt erstellt wird: