WdfDeviceSetDeviceInterfaceStateEx-Funktion (wdfdevice.h)

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

Syntax

void WdfDeviceSetDeviceInterfaceStateEx(
  WDFDEVICE        Device,
  const GUID       *InterfaceClassGUID,
  PCUNICODE_STRING ReferenceString,
  BOOLEAN          IsInterfaceEnabled
);

Parameter

Device

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

InterfaceClassGUID

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

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.

IsInterfaceEnabled

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

Rückgabewert

Keine

Bemerkungen

Der Treiber kann diese Funktion entweder vor oder nach dem Starten des Geräts aufrufen.

Beim Aufruf vor dem Start des Geräts (z. B. von EvtDriverDeviceAdd, EvtChildListCreateDevice oder EvtDevicePrepareHardware) sollte der Treiber IsInterfaceEnabled auf FALSE festlegen, um zu verhindern, dass die Schnittstelle während des PnP-Starts automatisch aktiviert wird. Das Festlegen des Parameters auf TRUE vor dem Starten des Geräts ist redundant, und ein solcher Aufruf sollte entfernt werden.

Beim Aufrufen, nachdem das Gerät gestartet wurde, ist das Verhalten identisch mit WdfDeviceSetDeviceInterfaceState.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 2004
KMDF-Mindestversion	1.31
UMDF-Mindestversion	1.31
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL

Weitere Informationen

WdfDeviceSetDeviceInterfaceState

Aktivieren und Deaktivieren einer Geräteschnittstelle