função de retorno de chamada EVT_SERCX_RECEIVE_CANCEL (sercx.h)
A função de retorno de chamada de evento EvtSerCxReceiveCancel notifica o driver do controlador serial de que a solicitação de recebimento pendente foi cancelada.
Sintaxe
EVT_SERCX_RECEIVE_CANCEL EvtSercxReceiveCancel;
void EvtSercxReceiveCancel(
[in] WDFDEVICE Device
)
{...}
Parâmetros
[in] Device
Um identificador WDFDEVICE para o objeto de dispositivo de estrutura que representa o controlador serial.
Retornar valor
Nenhum
Comentários
A extensão de estrutura serial (SerCx) chama essa função para informar ao driver do controlador serial que a solicitação de recebimento atual foi cancelada. Se o driver tiver uma operação de recebimento pendente em andamento, o driver deverá cancelar essa operação e chamar o método SerCxProgressReceive para relatar o cancelamento. Na chamada SerCxProgressReceive , defina BytesReceived como o número de bytes recebidos antes de a operação ser cancelada e defina ReceiveStatus como SerCxStatusCancelled.
Para registrar uma função de retorno de chamada EvtSerCxReceiveCancel , o driver deve chamar o método SerCxInitialize .
Exemplos
O tipo de função para esse retorno de chamada é declarado em Sercx.h, da seguinte maneira.
typedef VOID
EVT_SERCX_RECEIVE_CANCEL(
__in WDFDEVICE Device
);
Para definir uma função de retorno de chamada EvtSerCxReceiveCancel chamada MyEvtSerCxReceiveCancel
, primeiro você deve fornecer uma declaração de função que o SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação exigem, da seguinte maneira.
EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;
Em seguida, implemente a função de retorno de chamada da seguinte maneira.
VOID
MyEvtSerCxReceiveCancel(
__in WDFDEVICE Device
)
{ ... }
Para obter mais informações sobre os requisitos de SDV para declarações de função, consulte Declarando funções usando tipos de função de função para drivers KMDF.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível a partir do Windows 8. |
Plataforma de Destino | Área de Trabalho |
Cabeçalho | sercx.h |
IRQL | Chamado em IRQL <= DISPATCH_LEVEL |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de