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

La función de devolución de llamada de eventos EvtSerCx2CustomTransmitTransactionInitialize se llama mediante la versión 2 de la extensión de marco de serie (SerCx2) para preparar el controlador del controlador serie para realizar una transacción de transmisión personalizada.

Sintaxis

EVT_SERCX2_CUSTOM_TRANSMIT_TRANSACTION_INITIALIZE EvtSercx2CustomTransmitTransactionInitialize;

void EvtSercx2CustomTransmitTransactionInitialize(
  [in] SERCX2CUSTOMTRANSMITTRANSACTION CustomTransmitTransaction,
  [in] PMDL Mdl,
  [in] ULONG Offset,
  [in] ULONG Length
)
{...}

Parámetros

[in] CustomTransmitTransaction

Identificador de SERCX2CUSTOMTRANSMITTRANSACTION a un objeto de transmisión personalizado. El controlador de controlador serie llamó anteriormente al método SerCx2CustomTransmitTransactionCreate para crear este objeto.

[in] Mdl

Puntero a un MDL que describe las páginas de memoria que abarca el búfer de escritura para la transacción de transmisión personalizada. La lista de dispersión y recopilación de la transferencia DMA usará la región de esta memoria especificada por el offset de y parámetros length.

[in] Offset

Desplazamiento inicial de la transferencia de datos. Este parámetro es un desplazamiento de bytes desde el principio de la región del búfer descrita por MDL. Si MDL especifica un total de N bytes de espacio en búfer, los valores posibles de desplazamiento están en el intervalo de 0 a N-1.

[in] Length

Tamaño, en bytes, de la transferencia de datos. Si MDL especifica un total de N bytes de espacio en búfer, los valores posibles de Longitud están en el intervalo de 1 a N-Desplazamiento.

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 SerCx2CustomTransmitTransactionCreate llamada que crea el objeto de transmisión personalizado.

El controlador debe implementar una función EvtSerCx2CustomTransmitTransactionInitialize si necesita inicializar el controlador serie y el hardware asociado como preparación para una nueva transacción de transmisión personalizada. SerCx2 llama a esta función, si se implementa, antes de iniciar la transacción de transmisión personalizada. En respuesta a esta llamada, el controlador del controlador serie debe llamar al método SerCx2CustomTransmitTransactionInitializeComplete para notificar a SerCx2 una vez finalizada la inicialización.

Para obtener más información, vea SerCx2 Custom-Transmit Transactions.

Ejemplos

Para definir una función de devolución de llamada EvtSerCx2CustomTransmitTransactionInitialize, 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 EvtSerCx2CustomTransmitTransactionInitialize función de devolución de llamada denominada MyCustomTransmitTransactionInitialize, use el tipo de función EVT_SERCX2_CUSTOM_TRANSMIT_TRANSACTION_INITIALIZE, como se muestra en este ejemplo de código:

EVT_SERCX2_CUSTOM_TRANSMIT_TRANSACTION_INITIALIZE  MyCustomTransmitTransactionInitialize;

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

_Use_decl_annotations_
VOID
  MyCustomTransmitTransactionInitialize(
    SERCX2CUSTOMTRANSMITTRANSACTION  CustomTransmitTransaction,
    WDFREQUEST  Request,
    PMDL  Mdl,
    ULONG  Offset,
    ULONG  Length
    )
  {...}

El tipo de función EVT_SERCX2_CUSTOM_TRANSMIT_TRANSACTION_INITIALIZE 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_CUSTOM_TRANSMIT_TRANSACTION_INITIALIZE 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

IRP_MJ_WRITE

MDL

SERCX2CUSTOMTRANSMITTRANSACTION

SerCx2CustomTransmitTransactionCreate