Compartilhar via

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

  • Artigo

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 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 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 como o número de bytes transmitidos antes do cancelamento da operação e defina TransmitStatus como 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 chamada MyEvtSerCxTransmitCancel, 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_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 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