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) |