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

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

Sintaxis

EVT_SERCX_RECEIVE_CANCEL EvtSercxReceiveCancel;

void EvtSercxReceiveCancel(
  [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 que se ha cancelado la solicitud de recepción actual. Si el controlador tiene una operación de recepción pendiente en curso, el controlador debe cancelar esta operación y llamar al método SerCxProgressReceive para notificar la cancelación. En la llamada de SerCxProgressReceive, establezca BytesReceived en el número de bytes recibidos antes de cancelar la operación y establezca ReceiveStatus en SerCxStatusCancelled.

Para registrar una función de devolución de llamada EvtSerCxReceiveCancel, 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_RECEIVE_CANCEL(
    __in WDFDEVICE Device
    );

Para definir un EvtSerCxReceiveCancel función de devolución de llamada denominada MyEvtSerCxReceiveCancel, 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_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;

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

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

Consulte también

SerCxInitialize

serCxProgressReceive