Compartilhar via


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

SerCxInitialize

SerCxProgressReceive