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

La función de devolución de llamada de evento EvtSerCx2FileClose llama a la versión 2 de la extensión del marco serie (SerCx2) para notificar al controlador de controlador de serie que el cliente liberó el objeto de archivo que representa la conexión lógica al dispositivo del controlador serie.

Sintaxis

EVT_SERCX2_FILECLOSE EvtSercx2Fileclose;

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

Parámetros

[in] Device

Un identificador WDFDEVICE para el objeto de dispositivo de marco que representa el controlador serie. El controlador de controlador serie creó este objeto en su función de devolución de llamada EvtDriverDeviceAdd. Para obtener más información, vea SerCx2InitializeDevice.

Valor devuelto

Ninguno

Observaciones

El controlador de controlador serie puede, como opción, implementar esta función. Si se implementa, el controlador registra esta función en la llamada al método SerCx2InitializeDevice que finaliza la inicialización del objeto de dispositivo de marco para el controlador serie.

Para obtener más información, vea Framework File Objects.

Ejemplos

Para definir un EvtSerCx2FileClose 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 EvtSerCx2FileClose función de devolución de llamada denominada MyFileClose, use el tipo de función EVT_SERCX2_FILECLOSE, como se muestra en este ejemplo de código:

EVT_SERCX2_FILECLOSE  MyFileClose;

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

_Use_decl_annotations_
VOID
  MyFileClose(
    WDFDEVICE  Device
    )
  {...}

El tipo de función EVT_SERCX2_FILECLOSE 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_FILECLOSE 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

serCx2InitializeDevice