Compartilhar via

Função UdecxWdfDeviceTryHandleUserIoctl (udecxwdfdevice.h)

  • Artigo

Tenta lidar com uma solicitação IOCTL enviada por um software de modo de usuário.

Sintaxe

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

Parâmetros

UdecxWdfDevice

Um identificador para um objeto de dispositivo de estrutura que representa o controlador. O driver cliente inicializou esse objeto na chamada anterior para UdecxWdfDeviceAddUsbDeviceEmulation.

[in] Request

Um identificador para um objeto de solicitação de estrutura que representa a solicitação IOCTL.

Retornar valor

TRUE indica que a extensão de classe de emulação de dispositivo USB (UdeCx) reconheceu e concluiu a solicitação (com êxito ou falha). Nesse caso, o driver do cliente não deve concluir a solicitação. CASO contrário, FALSE; o driver deve concluir a solicitação.

Comentários

O driver do cliente UDE se apresenta ao software no modo de usuário como um driver de controlador de host. O driver cliente registra e expõe o GUID da interface do dispositivo GUID_DEVINTERFACE_USB_HOST_CONTROLLER. O software no modo de usuário pode abrir um identificador para o dispositivo especificando esse GUID. Usando esse identificador, o software pode enviar solicitações IOCTL.

Nota Observe que os códigos IOCTL de outra interface podem se sobrepor à interface do controlador de host USB. Se essa E/S atingir essa função, o IOCTL não será tratado corretamente.
 
O driver cliente não precisa processar o IOCTL recebido. Ele pode enviar a solicitação para a extensão de classe chamando UdecxWdfDeviceTryHandleUserIoctl. Se a extensão de classe reconhecer a solicitação como uma solicitação padrão, ela a concluirá. Caso contrário, a chamada falhará e o driver cliente deverá concluir a solicitação. Para obter uma lista de IOCTLs que devem ser tratadas, consulte IOCTLs USB para aplicativos e serviços.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Versão mínima do KMDF 1.15
Cabeçalho udecxwdfdevice.h (include Udecx.h)
Biblioteca Udecxstub.lib
IRQL PASSIVE_LEVEL

Confira também

Arquitetura: UDE (emulação de dispositivo USB)

Escrever um driver de cliente UDE