Função UdecxUsbDeviceInitSetEndpointsType (udecxusbdevice.h)

Artigo
08/07/2023

Indica o tipo de ponto de extremidade (simples ou dinâmico) nos parâmetros de inicialização que o driver cliente usa para criar o dispositivo USB virtual.

Sintaxe

void UdecxUsbDeviceInitSetEndpointsType(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      UDECX_ENDPOINT_TYPE  UdecxEndpointType
);

Parâmetros

[in, out] UdecxUsbDeviceInit

Um ponteiro para uma estrutura alocada pelo WDF que contém parâmetros de inicialização para o dispositivo USB virtual. O driver cliente recuperou esse ponteiro na chamada anterior para UdecxUsbDeviceInitAllocate.

[in] UdecxEndpointType

Um valor de tipo UDECX_ENDPOINT_TYPE que indica o tipo de ponto de extremidade USB.

Retornar valor

Nenhum

Comentários

Antes de criar o dispositivo USB virtual, o driver cliente deve indicar o tipo de ponto de extremidade que ele dá suporte. Ele pode dar suporte a um dos dois tipos (definidos em UDECX_ENDPOINT_TYPE):

Ponto de extremidade simples – o driver do cliente cria todos os objetos de ponto de extremidade antes de conectar o dispositivo. O dispositivo deve ter apenas uma configuração e uma configuração de interface por interface.
Ponto de extremidade dinâmico – o cliente cria objetos de ponto de extremidade na função de retorno de chamada EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE . A extensão de classe de emulação de dispositivo USB (UdeCx) invoca a implementação do driver quando obtém uma solicitação para adicionar ou configurar pontos de extremidade.

O UdecxUsbDeviceInit é uma estrutura opaca que contém ponteiros para funções de retorno de chamada relacionadas a pontos de extremidade. Se o driver cliente der suporte a pontos de extremidade dinâmicos, essas funções de retorno de chamada deverão ser implementadas pelo driver:

Antes de chamar esse método, o driver cliente deve ter definido esses ponteiros chamando UdecxUsbDeviceInitSetStateChangeCallbacks.

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	udecxusbdevice.h (inclua Udecx.h)
Biblioteca	Udecxstub.lib
IRQL	PASSIVE_LEVEL