EVT_SERCX_FILEOPEN función de devolución de llamada (sercx.h)
El EvtSerCxFileOpen función de devolución de llamada de eventos notifica al controlador de controlador serie que un cliente abrió un identificador de archivo en el dispositivo de controlador serie y que se ha creado un objeto de archivo para representar el dispositivo.
Sintaxis
EVT_SERCX_FILEOPEN EvtSercxFileopen;
NTSTATUS EvtSercxFileopen(
[in] WDFDEVICE Device
)
{...}
Parámetros
[in] Device
Un identificador WDFDEVICE para el objeto de dispositivo de marco que representa el controlador serie.
Valor devuelto
La función EvtSerCxFileOpen devuelve STATUS_SUCCESS si la llamada se realiza correctamente. De lo contrario, devuelve un código de estado de error adecuado.
Observaciones
La extensión del marco de trabajo serie (SerCx) llama a esta función para preparar el hardware del controlador serie para aceptar solicitudes de operaciones de E/S. Esta función debe configurar el controlador en un estado en el que esté listo para recibir y transmitir datos. Si se requieren interrupciones, esta función debe habilitar las interrupciones. Además, esta función debe asignar cualquier memoria necesaria solo durante la vigencia del objeto de archivo. Por ejemplo, esta función puede asignar un búfer de datos de interrupción.
Para registrar una función de devolución de llamada EvtSerCxFileOpen, 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 NTSTATUS
EVT_SERCX_FILEOPEN(
__in WDFDEVICE Device
);
Para definir un EvtSerCxFileOpen función de devolución de llamada denominada MyEvtSerCxFileOpen, 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_FILEOPEN MyEvtSerCxFileOpen;
A continuación, implemente la función de devolución de llamada de la manera siguiente.
NTSTATUS
MyEvtSerCxFileOpen(
__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 |