IDriverEntry::OnInitialize-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die OnInitialize Methode führt alle Vorgänge aus, die zum Initialisieren eines Treibers erforderlich sind.
Syntax
HRESULT OnInitialize(
[in] IWDFDriver *pWdfDriver
);
Parameter
[in] pWdfDriver
Ein Zeiger auf die IWDFDriver Schnittstelle für das Frameworktreiberobjekt, das den Treiber darstellt, der im Hostprozess geladen wird.
Rückgabewert
OnInitialize gibt S_OK zurück, wenn der Treiber seine globale Initialisierung abgeschlossen hat. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind. Wenn der Treiber einen Fehlercode zurückgibt, wird der Treiber vom Framework nicht geladen.
Bemerkungen
Das Framework erstellt ein neues Treiberobjekt für jeden Treiber, der im Treiberhostprozess geladen wird. Wenn ein Treiber in das System wechselt, ruft das Framework OnInitialize auf, um den Treiber zu benachrichtigen und die IWDFDriver--Schnittstelle im Aufruf zu übergeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | wudfddi.h (include Wudfddi.h) |