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 |