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 zu einem Framework-Geräteobjekt.
InterfaceClassGUID
Ein Zeiger auf eine GUID, die die Geräteschnittstellenklasse identifiziert.
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.
IsInterfaceEnabled
Ein boolescher Wert, der, wenn TRUE, die angegebene Geräteschnittstelleninstanz aktiviert oder, wenn FALSE-deaktiviert.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann diese Funktion entweder vor oder nach dem Start des Geräts aufrufen.
Wenn vor dem Start des Geräts aufgerufen wird (z. B. von EvtDriverDeviceAdd, EvtChildListCreateDeviceoder 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, bevor das Gerät gestartet wird, ist redundant, und ein solcher Aufruf sollte entfernt werden.
Beim Aufrufen nach dem Start des Geräts entspricht das Verhalten WdfDeviceSetDeviceInterfaceState.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 2004 |
| Minimale KMDF-Version | 1.31 |
| Mindest-UMDF-Version | 1.31 |
| Header- | wdfdevice.h (einschließen Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL- | PASSIVE_LEVEL |