Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 |