WdfDeviceSetDeviceInterfaceState-Funktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

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

Syntax

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

Parameter

[in] Device

Ein Handle zu einem 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 Referenzzeichenfolge für die Geräteschnittstelle beschreibt. Dieser Parameter ist optional und kann NULL-werden.

[in] IsInterfaceEnabled

Ein boolescher Wert, der, wenn TRUE, die angegebene Geräteschnittstelleninstanz aktiviert oder, wenn FALSE-deaktiviert.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Weitere Informationen zu Geräteschnittstellen und der WdfDeviceSetDeviceInterfaceState--Methode finden Sie unter Using Device Interfaces.

Beispiele

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

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

Anforderungen

Siehe auch

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx