EVT_UDECX_USB_ENDPOINT_PURGE função de retorno de chamada (udecxusbendpoint.h)

  • Artigo

A extensão de classe de emulação de dispositivo USB (UdeCx) invoca essa função de retorno de chamada para parar de enfileirar solicitações de E/S para a fila do ponto de extremidade e cancelar solicitações não processadas.

Sintaxe

EVT_UDECX_USB_ENDPOINT_PURGE EvtUdecxUsbEndpointPurge;

void EvtUdecxUsbEndpointPurge(
  [in] UDECXUSBENDPOINT UdecxUsbEndpoint
)
{...}

Parâmetros

[in] UdecxUsbEndpoint

Um identificador para um objeto de ponto de extremidade UDE que representa o ponto de extremidade para o qual as solicitações de E/S devem ser canceladas. O driver cliente recuperou esse ponteiro na chamada anterior para UdecxUsbEndpointCreate.

Retornar valor

Nenhum

Comentários

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

Na implementação, o driver do cliente é necessário para garantir que todas as E/S encaminhadas da fila do ponto de extremidade sejam concluídas e que a solicitação de E/S encaminhada recentemente falhe, até que o UdeCx invoque EVT_UDECX_USB_ENDPOINT_START. Normalmente, essas tarefas são obtidas chamando WdfIoQueuePurge. Essa chamada é assíncrona e o rio cliente deve chamar UdecxUsbEndpointPurgeComplete.

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 udecxusbendpoint.h (inclua Udecx.h)
IRQL <=DISPATCH_LEVEL

Confira também

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

Gerenciando filas de E/S

Escrever um driver de cliente UDE