UdecxWdfDeviceTryHandleUserIoctl-Funktion (udecxwdfdevice.h)

Artikel
02/26/2024

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

Syntax

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

Parameter

UdecxWdfDevice

Ein Handle für ein Framework-Geräteobjekt, das den Controller darstellt. Der Clienttreiber hat dieses Objekt im vorherigen Aufruf von UdecxWdfDeviceAddUsbDeviceEmulation initialisiert.

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt, das die IOCTL-Anforderung darstellt.

Rückgabewert

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

Hinweise

Der UDE-Clienttreiber präsentiert sich gegenüber Der Benutzermodussoftware als Hostcontrollertreiber. Der Clienttreiber registriert und macht die GUID_DEVINTERFACE_USB_HOST_CONTROLLER Geräteschnittstellen-GUID verfügbar. Benutzermodussoftware kann ein Handle für das Gerät öffnen, indem sie diese GUID angibt. Mithilfe dieses Handles kann die Software IOCTL-Anforderungen senden.

Hinweis Beachten Sie, dass sich die IOCTL-Codes einer anderen Schnittstelle mit der USB-Hostcontrollerschnittstelle überschneiden können. Wenn diese 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 UdecxWdfDeviceTryHandleUserIoctl aufgerufen wird. Wenn die Klassenerweiterung die Anforderung als Standardanforderung erkennt, wird sie abgeschlossen. Andernfalls schlägt der Aufruf fehl, und es wird erwartet, dass der Clienttreiber die Anforderung abgeschlossen hat. Eine Liste der IOCTLs, die verarbeitet werden müssen, finden Sie unter USB-IOCTLs für Anwendungen und Dienste.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
KMDF-Mindestversion	1.15
Kopfzeile	udecxwdfdevice.h (include Udecx.h)
Bibliothek	Udecxstub.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

Architektur: USB-Geräteemulation (UDE)

Schreiben eines UDE-Clienttreibers

Share via