Função UdecxWdfDeviceTryHandleUserIoctl (udecxwdfdevice.h)

Artigo
02/07/2025

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.

Valor de retorno

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 cliente não deve concluir a solicitação. FALSE caso contrário; o driver deve concluir a solicitação.

Observações

O driver cliente UDE apresenta-se ao software do modo de usuário como um driver do 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.

Observação 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 tratados, consulte IOCTLs USB para aplicativos e serviços.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
versão mínima do KMDF	1.15
cabeçalho	udecxwdfdevice.h (inclua Udecx.h)
biblioteca	Udecxstub.lib
IRQL	PASSIVE_LEVEL

Consulte também

Arquitetura : UDE (Emulação de Dispositivo USB)

gravar um driver de cliente UDE

Partilhar via