Compartilhar via

Função UdecxWdfDeviceAddUsbDeviceEmulation (udecxwdfdevice.h)

  • Artigo

Inicializa um objeto de dispositivo de estrutura para dar suporte a operações relacionadas a um controlador de host e a um dispositivo USB virtual anexado ao controlador.

Sintaxe

NTSTATUS UdecxWdfDeviceAddUsbDeviceEmulation(
       WDFDEVICE                WdfDevice,
  [in] PUDECX_WDF_DEVICE_CONFIG Config
);

Parâmetros

WdfDevice

Um identificador para o objeto de dispositivo de estrutura que o driver cliente recuperou na chamada anterior para WdfDeviceCreate.

[in] Config

Um ponteiro para uma estrutura UDECX_WDF_DEVICE_CONFIG que o driver do cliente inicializou chamando UDECX_WDF_DEVICE_CONFIG_INIT.

Retornar valor

O método retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método pode retornar um código de erro NTSTATUS apropriado.

Comentários

O driver do cliente UDE para o controlador de host emulado e o dispositivo USB devem chamar esse método após a chamada WdfDeviceCreate .

Durante essa chamada, as implementações de retorno de chamada de evento fornecidas pelo driver do cliente também são registradas. Forneça ponteiros de função para essas funções definindo os membros apropriados da configuração de UDECX_WDF_DEVICE_CONFIG.

O método torna o objeto de dispositivo de estrutura capaz de executar operações relacionadas a um controlador e seu hub raiz, como lidar com várias filas necessárias para processar solicitações IOCTL enviadas para o dispositivo USB anexado.

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