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

La función de devolución de llamada de eventos EvtSerCx2FileOpen se llama a la versión 2 de la extensión del marco de trabajo serie (SerCx2) para notificar al controlador de serie que un cliente abrió una conexión lógica al dispositivo del controlador serie y que se ha creado un objeto de archivo para representar esta conexión.

Sintaxis

EVT_SERCX2_FILEOPEN EvtSercx2Fileopen;

NTSTATUS EvtSercx2Fileopen(
  [in] WDFDEVICE Device
)
{...}

Parámetros

[in] Device

Un controlador WDFDEVICE para el objeto de dispositivo de marco que representa el controlador serie. El controlador del 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

La función EvtSerCx2FileOpen devuelve STATUS_SUCCESS si la llamada es correcta. De lo contrario, devuelve un código de estado de error adecuado.

Comentarios

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. SerCx2 llama a la función EvtSerCx2FileOpen cuando un controlador cliente abre un identificador de archivo en la pila de controladores del controlador serie.

Para obtener más información, vea Objetos de archivo de marco.

Ejemplos

Para definir una función de devolución de llamada EvtSerCx2FileOpen , 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 Code Analysis for Drivers, Static Driver Verifier (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 una función de devolución de llamada EvtSerCx2FileOpen denominada MyFileOpen, use el tipo de función EVT_SERCX2_FILEOPEN , como se muestra en este ejemplo de código:

EVT_SERCX2_FILEOPEN  MyFileOpen;

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

_Use_decl_annotations_
NTSTATUS
  MyFileOpen(
    WDFDEVICE  Device
    )
  {...}

El tipo de función EVT_SERCX2_FILEOPEN 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_FILEOPEN 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 roles de función para controladores KMDF. Para obtener más información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 8.1.
Plataforma de destino	Escritorio
Encabezado	sercx.h
IRQL	Se llama en IRQL <= DISPATCH_LEVEL.

Consulte también

SerCx2InitializeDevice