EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE 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 alterar a configuração selecionando uma configuração alternativa, desabilitando pontos de extremidade atuais ou adicionando pontos de extremidade dinâmicos.
Sintaxe
EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE EvtUdecxUsbDeviceEndpointsConfigure;
void EvtUdecxUsbDeviceEndpointsConfigure(
[in] UDECXUSBDEVICE UdecxUsbDevice,
[in] WDFREQUEST Request,
[in] PUDECX_ENDPOINTS_CONFIGURE_PARAMS Params
)
{...}
Parâmetros
[in] UdecxUsbDevice
Um identificador para o objeto de dispositivo UDE. O driver cliente criou esse objeto em uma chamada anterior para UdecxUsbDeviceCreate.
[in] Request
Um identificador para um objeto de solicitação de estrutura que representa a solicitação.
[in] Params
Um ponteiro para uma estrutura UDECX_ENDPOINTS_CONFIGURE_PARAMS que descreve as opções de configuração.
Retornar valor
Nenhum
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.
A extensão de classe invoca essa função de retorno de chamada para solicitar que o driver cliente configure um ou mais novos pontos de extremidade em hardware e/ou informa o driver quando um ou mais pontos de extremidade existentes não estão mais sendo usados.
Depois de criar pontos de extremidade, para cada novo ponto de extremidade, o driver cliente deve chamar UdecxUsbEndpointSetWdfIoQueue antes de concluir a solicitação.
Depois de liberar pontos de extremidade, o driver do cliente não deve usar objetos de fila de estrutura associados aos pontos de extremidade. A extensão de classe considera essas filas como limpas para evitar solicitações futuras.
A extensão de classe também pode solicitar um novo valor de configuração ou uma configuração alternativa por meio desse retorno de chamada.
Essa chamada é assíncrona. O driver cliente deve sinalizar a conclusão com status concluindo a solicitação passada pela extensão de classe.
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 | <=DISPATCH_LEVEL |