IWDFDevice-Schnittstelle (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. 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. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die IWDFDevice-Schnittstelle macht ein Geräteobjekt verfügbar, bei dem es sich um eine Darstellung eines Geräts im System handelt.

Vererbung

Die IWDFDevice-Schnittstelle erbt von IWDFObject. IWDFDevice verfügt auch über folgende Arten von Membern:

• Methoden

Methoden

Die IWDFDevice-Schnittstelle verfügt über diese Methoden.

IWDFDevice::AssignDeviceInterfaceState Die AssignDeviceInterfaceState-Methode aktiviert oder deaktiviert die angegebene Geräteschnittstelle instance für ein Gerät.
IWDFDevice::CommitPnpState Die CommitPnpState-Methode committ den Zustand der Plug & Play-Eigenschaft (PnP) (d. h. aktiviert, deaktiviert oder auf den Standardzustand festgelegt), den die IWDFDevice::SetPnpState-Methode festgelegt hat.
IWDFDevice::ConfigureRequestDispatching Die ConfigureRequestDispatching-Methode konfiguriert die Warteschlangen von E/A-Anforderungen des angegebenen Typs für die angegebene E/A-Warteschlange.
IWDFDevice::CreateDeviceInterface Die CreateDeviceInterface-Methode erstellt eine instance einer Geräteschnittstellenklasse.
IWDFDevice::CreateIoQueue Die CreateIoQueue-Methode konfiguriert die Standard-E/A-Warteschlange, die einem Gerät zugeordnet ist, oder erstellt eine sekundäre E/A-Warteschlange für das Gerät.
IWDFDevice::CreateRequest Die CreateRequest-Methode erstellt ein unformatiertes Anforderungsobjekt.
IWDFDevice::CreateSymbolicLink Die CreateSymbolicLink-Methode erstellt eine symbolische Verknüpfung für das Gerät.
IWDFDevice::CreateWdfFile Die CreateWdfFile-Methode erstellt ein Dateiobjekt, das von einem Treiber verwendet werden soll.
IWDFDevice::GetDefaultIoQueue Die GetDefaultIoQueue-Methode ruft die Schnittstelle der Standard-E/A-Warteschlange für ein Gerät ab.
IWDFDevice::GetDefaultIoTarget Die GetDefaultIoTarget-Methode ruft die Schnittstelle des Standard-E/A-Ziels für ein Gerät instance ab.
IWDFDevice::GetDriver Die GetDriver-Methode ruft die Schnittstelle zum übergeordneten Treiberobjekt eines Geräts instance ab.
IWDFDevice::GetPnpState Die GetPnpState-Methode bestimmt, ob die angegebene Plug & Play -Eigenschaft (PnP) eines Geräts ein- oder ausgeschaltet ist (oder auf den Standardzustand festgelegt ist).
IWDFDevice::P ostEvent Die PostEvent-Methode benachrichtigt Anwendungen asynchron, die auf das angegebene Ereignis von einem Treiber warten.
IWDFDevice::RetrieveDeviceInstanceId Die RetrieveDeviceInstanceId-Methode ruft den Bezeichner eines instance eines Geräts ab.
IWDFDevice::RetrieveDeviceName Die RetrieveDeviceName-Methode ruft den Namen eines zugrunde liegenden Kernelmodusgeräts ab.
IWDFDevice::RetrieveDevicePropertyStore Die RetrieveDevicePropertyStore-Methode ruft eine Eigenschaftenspeicherschnittstelle ab. Treiber können die -Methode verwenden, um auf die Registrierung zuzugreifen.
IWDFDevice::SetPnpState Die SetPnpState-Methode aktiviert oder deaktiviert die angegebene Plug & Play -Eigenschaft (PnP) eines Geräts.

Hinweise

Jedes Geräteobjekt verfügt über ein übergeordnetes Treiberobjekt. Wenn ein neues Gerät im System eintrifft, ruft das Framework die Rückruffunktion IDriverEntry::OnDeviceAdd des übergeordneten Treibers auf, um den Treiber über die Ankunft zu benachrichtigen. Der Treiber kann dann die IWDFDriver::CreateDevice-Methode aufrufen, um einen Zeiger auf die IWDFDevice-Schnittstelle für das neue Geräteobjekt zu erhalten.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.5
Kopfzeile	wudfddi.h (include Wudfddi.h)