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. 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 AssignDeviceInterfaceState-Methode aktiviert oder deaktiviert die angegebene Geräteschnittstelle instance 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-Zeichenfolge, die den Namen des instance 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äteschnittstelle instance aktiviert oder deaktiviert werden soll. TRUE gibt an, dass aktiviert wird. FALSE gibt an, dass sie deaktiviert werden.
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.
Hinweise
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 zur 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 |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |