Funzione UdecxWdfDeviceTryHandleUserIoctl (udecxwdfdevice.h)

Articolo
02/29/2024

Tenta di gestire una richiesta IOCTL inviata da un software in modalità utente.

Sintassi

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

Parametri

UdecxWdfDevice

Handle per un oggetto dispositivo framework che rappresenta il controller. Il driver client ha inizializzato questo oggetto nella chiamata precedente a UdecxWdfDeviceAddUsbDeviceEmulation.

[in] Request

Handle a un oggetto richiesta framework che rappresenta la richiesta IOCTL.

Valore restituito

TRUE indica che l'estensione della classe di emulazione del dispositivo USB (UdeCx) ha riconosciuto e completato la richiesta (con esito positivo o negativo). In questo caso, il driver client non deve completare la richiesta. FALSE in caso contrario; il driver deve completare la richiesta.

Commenti

Il driver client UDE si presenta al software in modalità utente come driver del controller host. Il driver client registra ed espone il GUID dell'interfaccia del dispositivo GUID_DEVINTERFACE_USB_HOST_CONTROLLER. Il software in modalità utente può aprire un handle al dispositivo specificando tale GUID. Usando tale handle, il software può inviare richieste IOCTL.

Nota Si noti che i codici IOCTL di altre interfacce possono sovrapporsi all'interfaccia del controller host USB. Se tale I/O raggiunge questa funzione, L'IOCTL non verrà gestito correttamente.

Il driver client non deve elaborare l'IOCTL ricevuto. Può inviare la richiesta all'estensione della classe chiamando UdecxWdfDeviceTryHandleUserIoctl. Se l'estensione della classe riconosce la richiesta come richiesta standard, la completa. In caso contrario, la chiamata ha esito negativo e si prevede che il driver client completi la richiesta. Per un elenco di IOCTLs che devono essere gestiti, vedere IOCTLs USB per applicazioni e servizi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Versione KMDF minima	1.15
Intestazione	udecxwdfdevice.h (include Udecx.h)
Libreria	Udecxstub.lib
IRQL	PASSIVE_LEVEL

Vedi anche

Architettura: Emulazione dispositivo USB (UDE)

Scrivere un driver client UDE

Condividi tramite