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

La función de devolución de llamada de eventos evtSerCxFileClose notifica al controlador de controlador en serie que se ha liberado el objeto de archivo que representa el dispositivo del controlador serie.

Sintaxis

EVT_SERCX_FILECLOSE EvtSercxFileclose;

void EvtSercxFileclose(
  [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

Esta función debe quitar el dispositivo del controlador serie del estado en el que está listo para recibir y transmitir datos. Esta función debe deshabilitar las interrupciones si las interrupciones están habilitadas. Cualquier memoria asignada solo durante la vigencia del objeto de archivo se debe desasignar en esta función o en la función EvtSerCxFileCleanup.

Si el controlador del controlador serie implementa una función EvtSerCxFileCleanup, la extensión del marco serie (SerCx) llama a esta función antes de llamar a la función EvtSerCxFileClose. SerCx llama a la función EvtSerCxFileCleanup cuando un cliente cierra el último identificador del objeto de archivo que representa el dispositivo del controlador serie. Después de esta llamada, el controlador no recibe nuevas solicitudes de operaciones de E/S. SerCx llama a la función EvtSerCxFileClose cuando se libera el objeto de archivo, que se produce solo después de que se completen o cancelen todas las solicitudes de E/S pendientes.

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

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

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_FILECLOSE(
    __in WDFDEVICE Device
    );

Para definir un EvtSerCxFileClose función de devolución de llamada denominada MyEvtSerCxFileClose, 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_FILECLOSE MyEvtSerCxFileClose;

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

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

EvtSerCxFileCleanup

SerCxInitialize