Funzione UdecxWdfDeviceTryHandleUserIoctl (udecxwdfdevice.h)

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