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 de 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 UDECX_USB_ENDPOINT_INIT_AND_METADATA que contém o descritor de ponto de extremidade.

Retornar valor

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

Comentários

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
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 (include Udecx.h)
IRQL PASSIVE_LEVEL

Confira também

Arquitetura: UDE (emulação de dispositivo USB)

UdecxUsbEndpointCreate

Escrever um driver de cliente UDE