WdfDeviceSetDeviceInterfaceState-Funktion (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WdfDeviceSetDeviceInterfaceState-Methode aktiviert oder deaktiviert eine Geräteschnittstelle für ein angegebenes Gerät.

Hinweis

Der Treiber sollte diese Funktion erst aufrufen, nachdem das Gerät gestartet wurde. Rufen Sie stattdessen WdfDeviceSetDeviceInterfaceStateEx auf, um den Schnittstellenstatus vom Gerätezusatz zu ändern.

Syntax

void WdfDeviceSetDeviceInterfaceState(
  [in]           WDFDEVICE        Device,
  [in]           const GUID       *InterfaceClassGUID,
  [in, optional] PCUNICODE_STRING ReferenceString,
  [in]           BOOLEAN          IsInterfaceEnabled
);

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] InterfaceClassGUID

Ein Zeiger auf eine GUID, die die Geräteschnittstellenklasse identifiziert.

[in, optional] ReferenceString

Ein Zeiger auf eine UNICODE_STRING Struktur, die eine Verweiszeichenfolge für die Geräteschnittstelle beschreibt. Dieser Parameter ist optional und kann NULL sein.

[in] IsInterfaceEnabled

Ein boolescher Wert, der bei TRUE die angegebene Geräteschnittstelle instance aktiviert oder, wenn false, deaktiviert wird.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Weitere Informationen zu Geräteschnittstellen und der WdfDeviceSetDeviceInterfaceState-Methode finden Sie unter Verwenden von Geräteschnittstellen.

Beispiele

Im folgenden Codebeispiel wird die COM-Portschnittstelle eines Treibers deaktiviert.

WdfDeviceSetDeviceInterfaceState (
                                  Device,
                                  (LPGUID) &GUID_DEVINTERFACE_COMPORT,
                                  NULL,
                                  FALSE
                                  );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx