IWDFDevice::AssignDeviceInterfaceState-Methode (wudfddi.h)

  • Artikel

[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

Weitere Informationen

IWDFDevice

IWDFDevice::CreateDeviceInterface