Función SerCxCompleteWait (sercx.h)

Artículo
12/15/2024

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

Sintaxis

NTSTATUS SerCxCompleteWait(
  [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.

[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

serCxCompleteWait devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Entre los posibles valores devueltos de error se incluyen el siguiente código de estado.

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	El evento especificado no se incluye en la máscara de espera actual.

Observaciones

Cuando SerCx recibe una solicitud IOCTL_SERIAL_SET_WAIT_MASK de un cliente, el controlador de solicitudes de SerCx llama al EvtSerCxWaitmask función de devolución de llamada para notificar al controlador de serie que la máscara de espera ha cambiado. La máscara de espera especifica un conjunto de eventos de hardware para que se supervise el controlador serie. Durante esta llamada, el controlador descarta cualquier máscara de espera antigua que se haya especificado en una llamada de EvtSerCxWaitmask y, a continuación, configura el hardware del controlador serie para detectar los eventos en la nueva máscara de espera.

Más adelante, cuando se produce un evento en la nueva máscara de espera, el controlador llama a SerCxCompleteWait para notificar a SerCx del evento. Si una solicitud de IOCTL_SERIAL_WAIT_ON_MASK enviada anteriormente está pendiente, SerCxCompleteWait completa esta solicitud con un estado de STATUS_SUCCESS y una máscara de espera de salida que indica qué evento se ha producido. De lo contrario, SerCxCompleteWait almacena el evento en su historial de eventos interno en anticipación de una solicitud de IOCTL_SERIAL_WAIT_ON_MASK futura.