EVT_SERCX_TRANSMIT_CANCEL función de devolución de llamada (sercx.h)

La EvtSerCxTransmitCancel función de devolución de llamada de eventos notifica al controlador de controlador serie que se cancela la solicitud de transmisión pendiente.

Sintaxis

EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;

void EvtSercxTransmitCancel(
  [in] WDFDEVICE Device
)
{...}

Parámetros

[in] Device

Un identificador WDFDEVICE para el objeto de dispositivo de marco que representa el controlador serie.

Valor devuelto

Ninguno

Observaciones

La extensión del marco de trabajo serie (SerCx) llama a esta función para informar al controlador de controlador serie de que se ha cancelado la solicitud de transmisión actual. Si el controlador tiene una operación de transmisión pendiente en curso, el controlador debe cancelar esta operación y llamar al método SerCxProgressTransmit para notificar la cancelación. En la llamada SerCxProgressTransmit, establezca BytesTransmitted en el número de bytes transmitidos antes de que se canceló la operación y establezca transmitStatus en SerCxStatusCancelled.

Para registrar una función de devolución de llamada EvtSerCxTransmitCancel, el controlador debe llamar al método SerCxInitialize.

Ejemplos

El tipo de función para esta devolución de llamada se declara en Sercx.h, como se indica a continuación.

typedef VOID
  EVT_SERCX_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

Para definir un EvtSerCxTransmitCancel función de devolución de llamada denominada MyEvtSerCxTransmitCancel, primero debe proporcionar una declaración de función que comprobador de controladores estáticos (SDV) y otras herramientas de comprobación necesarias, como se indica a continuación.

EVT_SERCX_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;

A continuación, implemente la función de devolución de llamada de la manera siguiente.

VOID
  MyEvtSerCxTransmitCancel(
    __in WDFDEVICE Device
    )
{ ... }

Para obtener más información sobre los requisitos de SDV para las declaraciones de función, consulte Declaración de funciones mediante tipos de rol de función para controladores kmDF.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows 8.
de la plataforma de destino de	Escritorio
encabezado de	sercx.h
irQL	Se llama a irQL <= DISPATCH_LEVEL