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

Artigo
12/15/2024

A função de retorno de chamada de evento EvtSerCxTransmitCancel notifica o driver do controlador serial de que a solicitação de transmissão pendente foi cancelada.

Sintaxe

EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;

void EvtSercxTransmitCancel(
  [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 transmissão atual foi cancelada. Se o driver tiver uma operação de transmissão pendente em andamento, o driver deverá cancelar essa operação e chamar o método SerCxProgressTransmit para relatar o cancelamento. Na chamada SerCxProgressTransmit, defina BytesTransmitted para o número de bytes transmitidos antes do cancelamento da operação e defina TransmitStatus para SerCxStatusCancelled.

Para registrar uma função de retorno de chamada EvtSerCxTransmitCancel, 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_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

Para definir uma função de retorno de chamada EvtSerCxTransmitCancel denominada MyEvtSerCxTransmitCancel, 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_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;

Em seguida, implemente a função de retorno de chamada da seguinte maneira.

VOID
  MyEvtSerCxTransmitCancel(
    __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

Compartilhar via