Framework-Geräteobjekt

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 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden.

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

Weitere Informationen finden Sie unter Erste Schritte mit UMDF.

Das Framework-Geräteobjekt wird von der IWDFDevice-Schnittstelle für Treiber verfügbar gemacht. Das Framework-Geräteobjekt ist die Frameworkdarstellung des Geräts im System. Jedes Geräteobjekt verfügt über ein übergeordnetes Treiberobjekt.

Wenn ein neues Gerät im System eintrifft, ruft das Framework die IDriverEntry::OnDeviceAdd-Methode auf, um den Treiber über die Ankunft zu benachrichtigen, und übergibt die Schnittstellen IWDFDriver und IWDFDeviceInitialize im Aufruf. Der Treiber kann Methoden der IWDFDeviceInitialize-Schnittstelle aufrufen, um das neue Gerät zu initialisieren. Der Treiber ruft beispielsweise die IWDFDeviceInitialize::RetrieveDevicePropertyStore-Methode auf, um die Geräteinformationen abzufragen, die im Rahmen der Geräteinstallation bereitgestellt werden. Der Treiber kann dann die IWDFDriver::CreateDevice-Methode aufrufen, um das Geräteobjekt zu konfigurieren und zu erstellen.

Wenn Treiber ein Framework-Geräteobjekt erstellen, können sie ihre Schnittstellen IPnpCallback, IPnpCallbackSelfManagedIo, IPnpCallbackHardware, IFileCallbackCleanup und IFileCallbackClose registrieren. Das Framework benachrichtigt den Treiber dann, wenn Dateibereinigung und -schließen sowie Plug & Play (PnP) und Energieverwaltungsereignisse (Power Management, PM) auftreten. Weitere Informationen zur Unterstützung von PnP und PM finden Sie unter PnP und Power Management in UMDF-basierten Treibern.