Función SerCx2CompleteWait (sercx.h)

Artículo
10/30/2024

El método SerCx2CompleteWait notifica a la versión 2 de la extensión del marco de trabajo serie (SerCx2) que se ha producido un evento en la máscara de espera actual.

Sintaxis

void SerCx2CompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

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.

[in] Event

Tipo de evento que finaliza la operación de espera actual. Este parámetro es un valor de máscara de espera. Cada tipo de evento corresponde a un bit determinado en la máscara de espera. Este bit se establece para indicar que se ha producido el evento correspondiente. Para obtener más información sobre los tipos de eventos que puede especificar una máscara de espera, vea SERIAL_EV_XXX.

Valor devuelto

Ninguno

Observaciones

Cuando SerCx2 recibe una solicitud de IOCTL_SERIAL_SET_WAIT_MASK de un cliente, el controlador de solicitudes de SerCx2 llama al EvtSerCx2SetWaitMask función de devolución de llamada para notificar al controlador de controlador serie que la máscara de espera ha cambiado.

Cuando se produce un evento en la nueva máscara de espera, el controlador llama a SerCx2CompleteWait para notificar a SerCx2 del evento. Si una solicitud de IOCTL_SERIAL_WAIT_ON_MASK enviada anteriormente está pendiente en SerCx2 en el momento de la llamada SerCx2CompleteWait, SerCx2 completa esta solicitud con una máscara de espera de salida que indica qué evento se ha producido. De lo contrario, SerCx2 almacena el evento en su historial de eventos interno en anticipación de una solicitud de IOCTL_SERIAL_WAIT_ON_MASK futura.