IWDFDevice::AssignDeviceInterfaceState-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 AssignDeviceInterfaceState Methode aktiviert oder deaktiviert die angegebene Geräteschnittstelleninstanz für ein Gerät.
Syntax
HRESULT AssignDeviceInterfaceState(
[in] LPCGUID pDeviceInterfaceGuid,
[in, optional] PCWSTR pReferenceString,
[in] BOOL Enable
);
Parameter
[in] pDeviceInterfaceGuid
Ein Zeiger auf die GUID für eine Geräteschnittstellenklasse.
[in, optional] pReferenceString
Ein Zeiger auf eine NULL--terminated-Zeichenfolge, die den Namen der Instanz der Geräteschnittstelle enthält. Dieser Parameter ist optional. Der Treiber kann NULL- übergeben, wenn der Treiber keinen Namen angeben muss. Wenn der Treiber einen Namen angeben muss, darf die vom Treiber übergebene Zeichenfolge keine Pfadtrennzeichen ("/" oder "\") enthalten.
[in] Enable
Ein BOOL-Wert, der angibt, ob die Geräteschnittstelleninstanz aktiviert oder deaktiviert werden soll. TRUE gibt an, dass aktiviert werden soll; FALSE- gibt an, dass sie deaktiviert werden soll.
Rückgabewert
AssignDeviceInterfaceState gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.
Bemerkungen
Wenn IWDFDevice::CreateDeviceInterface erfolgreich ist, aktiviert und deaktiviert das Framework die Schnittstelle automatisch basierend auf dem PnP-Zustand des Geräts.
Verwenden Sie die AssignDeviceInterfaceState Methode, um eine Geräteschnittstelle manuell zu deaktivieren und erneut zu aktivieren.
Weitere Informationen zu Geräteschnittstellen finden Sie unter Verwenden von Geräteschnittstellen in UMDF-Treibern.
Beispiele
Ein Codebeispiel für die Verwendung der AssignDeviceInterfaceState--Methode finden Sie unter IWDFDevice::CreateDeviceInterface.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |