EVT_SERCX_RECEIVE_CANCEL função de retorno de chamada (sercx.h)

Artigo
12/13/2024

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 da estrutura que representa o controlador serial.

Valor de retorno

Nenhum

Observações

A extensão da 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 para o número de bytes recebidos antes do cancelamento da operação e defina ReceiveStatus para 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 denominada MyEvtSerCxReceiveCancel, primeiro você deve fornecer uma declaração de função que SDV (Static Driver Verifier) 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 para drivers KMDF.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8.
da Plataforma de Destino	Área de trabalho
cabeçalho	sercx.h
IRQL	Chamado no <DO IRQL = DISPATCH_LEVEL

Consulte também

SerCxInitialize

SerCxProgressReceive

Compartilhar via