Compartir a través de


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

La función de devolución de llamada de evento EvtSerCx2SystemDmaReceiveCleanupTransaction se llama a la función de devolución de llamada de eventos de la versión 2 de la extensión del marco de serie (SerCx2) para limpiar el estado del controlador serie después de que finalice una transacción de recepción del sistema DMA.

Sintaxis

EVT_SERCX2_SYSTEM_DMA_RECEIVE_CLEANUP_TRANSACTION EvtSercx2SystemDmaReceiveCleanupTransaction;

void EvtSercx2SystemDmaReceiveCleanupTransaction(
  [in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
)
{...}

Parámetros

[in] SystemDmaReceive

Identificador de SERCX2SYSTEMDMARECEIVE a un objeto system-DMA-receive. El controlador de controlador serie llamó anteriormente al método SerCx2SystemDmaReceiveCreate para crear este objeto.

Valor devuelto

Ninguno

Observaciones

El controlador de controlador serie puede, como opción, implementar esta función. Si se implementa, el controlador registra la función en el SerCx2SystemDmaReceiveCreate llamada que crea el objeto system-DMA-receive.

El controlador de controlador serie debe implementar un EvtSerCx2SystemDmaReceiveCleanupTransaction función si necesita limpiar el estado del controlador serie al final de una transacción system-DMA-receive. SerCx2 llama a esta función, si se implementa, después de que finalice una transacción system-DMA-receive. En respuesta a la llamada EvtSerCx2SystemDmaReceiveCleanupTransaction, el controlador de controlador serie debe llamar al método SerCx2SystemDmaReceiveCleanupTransactionComplete para notificar a SerCx2 después de realizar el trabajo de limpieza.

Para obtener más información, vea SerCx2 System-DMA-Receive Transactions.

Ejemplos

Para definir un EvtSerCx2SystemDmaReceiveCleanupTransaction función de devolución de llamada, primero debe proporcionar una declaración de función que identifique el tipo de función de devolución de llamada que está definiendo. Windows proporciona un conjunto de tipos de función de devolución de llamada para controladores. Declarar una función mediante los tipos de función de devolución de llamada ayuda a Análisis de código para controladores, comprobador de controladores estáticos (SDV) y otras herramientas de comprobación encuentran errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir un EvtSerCx2SystemDmaReceiveCleanupTransaction función de devolución de llamada denominada MySystemDmaReceiveCleanupTransaction, use el tipo de función EVT_SERCX2_SYSTEM_DMA_RECEIVE_CLEANUP_TRANSACTION, como se muestra en este ejemplo de código:

EVT_SERCX2_SYSTEM_DMA_RECEIVE_CLEANUP_TRANSACTION  MySystemDmaReceiveCleanupTransaction;

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

_Use_decl_annotations_
VOID
  MySystemDmaReceiveCleanupTransaction(
    SERCX2SYSTEMDMARECEIVE  SystemDmaReceive
    )
  {...}

El tipo de función EVT_SERCX2_SYSTEM_DMA_RECEIVE_CLEANUP_TRANSACTION se define en el archivo de encabezado Sercx.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función EVT_SERCX2_SYSTEM_DMA_RECEIVE_CLEANUP_TRANSACTION en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante tipos de rol de función para controladores kmDF. Para obtener más información sobre Use_decl_annotations, vea Anotación del comportamiento de la función.

Requisitos

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

Consulte también

SERCX2SYSTEMDMARECEIVE

SerCx2SystemDmaReceiveCleanupTransactionComplete

SerCx2SystemDmaReceiveCreate