Partilhar via


EVT_UDECX_USB_DEVICE_ENDPOINT_ADD função de retorno de chamada (udecxusbdevice.h)

A extensão de classe de emulação de dispositivo USB (UdeCx) invoca essa função de retorno de chamada para solicitar que o driver cliente crie um ponto de extremidade dinâmico no dispositivo USB virtual.

Sintaxe

EVT_UDECX_USB_DEVICE_ENDPOINT_ADD EvtUdecxUsbDeviceEndpointAdd;

NTSTATUS EvtUdecxUsbDeviceEndpointAdd(
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] PUDECX_USB_ENDPOINT_INIT_AND_METADATA EndpointToCreate
)
{...}

Parâmetros

[in] UdecxUsbDevice

Um identificador para o objeto do dispositivo UDE para o qual o driver cliente cria um ponto de extremidade. O driver criou esse objeto em uma chamada anterior para UdecxUsbDeviceCreate.

[in] EndpointToCreate

Um ponteiro para uma estrutura de UDECX_USB_ENDPOINT_INIT_AND_METADATA que contém o descritor de ponto de extremidade.

Valor de retorno

Se a operação for bem-sucedida, a função de retorno de chamada deverá retornar STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a TRUE.

Observações

O driver cliente registrou essa função de retorno de chamada em uma chamada anterior para UdecxUsbDeviceInitSetStateChangeCallbacks fornecendo um ponteiro de função para sua implementação.

Na implementação, espera-se que o driver cliente crie o ponto de extremidade chamando UdecxUsbEndpointCreate usando os parâmetros de inicialização (UDECXUSBENDPOINT_INIT) passados pela extensão de classe na estrutura UDECX_USB_ENDPOINT_INIT_AND_METADATA.

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)
IRQL PASSIVE_LEVEL

Consulte também

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

UdecxUsbEndpointCreate

gravar um driver de cliente UDE