Auf Englisch lesen

Freigeben über

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 WdfDeviceSetDeviceInterfaceStateEx- auf, um den Schnittstellenstatus von "Device Add" zu ändern.

Syntax

C++ 
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.

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

Anforderungen

Anforderung Wert
Zielplattform- Universal
Minimale KMDF-Version 1.0
Mindest-UMDF-Version 2.0
Header- wdfdevice.h (einschließen Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL- PASSIVE_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx