Função UdecxWdfDeviceAddUsbDeviceEmulation (udecxwdfdevice.h)
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 da estrutura que o driver cliente recuperou na chamada anterior para WdfDeviceCreate.
[in] Config
Um ponteiro para uma estrutura de UDECX_WDF_DEVICE_CONFIG que o driver cliente inicializou chamando UDECX_WDF_DEVICE_CONFIG_INIT.
Valor de retorno
O método retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um código de erro NTSTATUS apropriado.
Observações
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 por meio da configuração de chamada de membros apropriados de UDECX_WDF_DEVICE_CONFIG.
O método torna o objeto do 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 ao dispositivo USB anexado.
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)