UdecxWdfDeviceTryHandleUserIoctl-Funktion (udecxwdfdevice.h)

Artikel
02/07/2025

Versucht, eine von einer Benutzermodussoftware gesendete IOCTL-Anforderung zu verarbeiten.

Syntax

BOOLEAN UdecxWdfDeviceTryHandleUserIoctl(
       WDFDEVICE  UdecxWdfDevice,
  [in] WDFREQUEST Request
);

Parameter

UdecxWdfDevice

Ein Handle zu einem Framework-Geräteobjekt, das den Controller darstellt. Der Clienttreiber initialisierte dieses Objekt im vorherigen Aufruf von UdecxWdfDeviceAddUsbDeviceEmulation.

[in] Request

Ein Handle zu einem Framework-Anforderungsobjekt, das die IOCTL-Anforderung darstellt.

Rückgabewert

TRUE gibt an, dass die ERWEITERUNG der USB-Geräteemulationsklasse (UdeCx) die Anforderung (mit Erfolg oder Fehler) erkannt und abgeschlossen hat. In diesem Fall darf der Clienttreiber die Anforderung nicht abschließen. ANDERNFALLS FALSE; der Treiber muss die Anforderung abschließen.

Bemerkungen

Der UDE-Clienttreiber stellt sich als Hostcontrollertreiber für die Benutzermodussoftware dar. Der Clienttreiber registriert und macht die GUID der GUID_DEVINTERFACE_USB_HOST_CONTROLLER Geräteschnittstelle verfügbar. Benutzermodussoftware kann ein Handle auf dem Gerät öffnen, indem sie diese GUID angeben. Mit diesem Handle kann die Software IOCTL-Anforderungen senden.

Hinweis Beachten Sie, dass die IOCTL-Codes anderer Schnittstellen mit der USB-Hostcontrollerschnittstelle überlappen können. Wenn eine solche E/A diese Funktion erreicht, wird die IOCTL nicht ordnungsgemäß behandelt.

Der Clienttreiber muss die empfangene IOCTL nicht verarbeiten. Sie kann die Anforderung an die Klassenerweiterung senden, indem UdecxWdfDeviceTryHandleUserIoctlaufgerufen wird. Wenn die Klassenerweiterung die Anforderung als Standardanforderung erkennt, wird sie abgeschlossen. Andernfalls schlägt der Aufruf fehl, und der Clienttreiber wird dann erwartet, dass die Anforderung abgeschlossen wird. Eine Liste der IOCTLs, die behandelt werden müssen, finden Sie unter USB-IOCTLs für Anwendungen und Dienste.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Minimale KMDF-Version	1.15
Header-	udecxwdfdevice.h (include Udecx.h)
Library	Udecxstub.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

Architektur: USB Device Emulation (UDE)

Schreiben eines UDE-Clienttreibers

Freigeben über