Função UdecxUsbDeviceInitSetEndpointsType (udecxusbdevice.h)

Artigo
02/07/2025

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 por 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_TYPEque indica o tipo de ponto de extremidade USB.

Valor de retorno

Nenhum

Observações

Antes de criar o dispositivo USB virtual, o driver cliente deve indicar o tipo de ponto de extremidade compatível. Ele pode dar suporte a um dos dois tipos (definido em UDECX_ENDPOINT_TYPE):

Ponto de extremidade simples – o driver 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
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	udecxusbdevice.h (inclua Udecx.h)
biblioteca	Udecxstub.lib
IRQL	PASSIVE_LEVEL