IOCTL_SERIAL_GET_WAIT_MASK IOCTL (ntddser.h)

Artículo
08/07/2023

La solicitud IOCTL_SERIAL_GET_WAIT_MASK devuelve la máscara de espera de eventos que está establecida actualmente para el controlador serie.

Un cliente puede esperar los eventos de espera representados por bits de marca SERIAL_EV_RXCHAR a través de SERIAL_EV_EVENT2. Para obtener más información sobre estas marcas de eventos, vea la sección Comentarios.

Para establecer una máscara de espera de eventos, un cliente puede usar una solicitud de IOCTL_SERIAL_SET_WAIT_MASK . Para esperar a que se produzca un evento de espera, un cliente usa una solicitud de IOCTL_SERIAL_WAIT_ON_MASK .

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

Ninguno.

Longitud del búfer de entrada

Ninguno.

Búfer de salida

El miembro AssociatedIrp.SystemBuffer apunta a un búfer ULONG asignado por el cliente que el controlador de controlador serie usa para generar la máscara de espera. La máscara de espera es cero o el or bit a bit de una o varias de las marcas de evento SERIAL_EV_XXX.

Longitud del búfer de salida

El miembro Parameters.DeviceIoControl.OutputBufferLength se establece en el tamaño, en bytes, de un ULONG.

Bloque de estado

Si la solicitud se realiza correctamente, el miembro Information se establece en el tamaño, en bytes, de un ULONG. De lo contrario, el miembro Information se establece en cero.

El miembro Status se establece en uno de los valores de estado genéricos para las solicitudes de control de dispositivos serie.

Comentarios

Las constantes SERIAL_EV_XXX definen los bits de marca de la máscara de espera para un puerto serie.

#define SERIAL_EV_RXCHAR     0x0001
#define SERIAL_EV_RXFLAG     0x0002
#define SERIAL_EV_TXEMPTY    0x0004
#define SERIAL_EV_CTS        0x0008
#define SERIAL_EV_DSR        0x0010
#define SERIAL_EV_RLSD       0x0020
#define SERIAL_EV_BREAK      0x0040
#define SERIAL_EV_ERR        0x0080
#define SERIAL_EV_RING       0x0100
#define SERIAL_EV_PERR       0x0200
#define SERIAL_EV_RX80FULL   0x0400
#define SERIAL_EV_EVENT1     0x0800
#define SERIAL_EV_EVENT2     0x1000

Las constantes SERIAL_EV_XXX definen los tipos de eventos que se pueden especificar en una máscara de espera. Después de que un cliente (aplicación o controlador periférico) abra una conexión a un puerto serie, el cliente puede especificar una máscara de espera que indique los tipos de eventos que el cliente necesita supervisar. Estos eventos son cambios en el estado de hardware del puerto serie. Cuando se produce un evento en la máscara de espera, se notifica al cliente.

Los IOCTL_SERIAL_SET_WAIT_MASK y IOCTL_SERIAL_GET_WAIT_MASK las solicitudes de control usan máscaras de espera de eventos para especificar un conjunto de eventos en los que un cliente puede esperar. Un valor de máscara de espera es cero o el or bit a bit de una o varias constantes SERIAL_EV_XXX . Un valor de máscara de espera de cero indica que el cliente no está esperando ningún evento.

El cliente envía una solicitud de control IOCTL_SERIAL_WAIT_ON_MASK para esperar un evento en la máscara de espera establecida actualmente. El controlador de controlador serie completa esta solicitud cuando se produce un evento en la máscara de espera.

En la tabla siguiente se muestran los bits de marca SERIAL_EV_XXX admitidos por SerCx2, SerCx y Serial.sys. Una entrada Sí de la tabla indica que la extensión o el controlador del marco de trabajo serie admiten el bit de marca correspondiente. Una entrada No indica que no se admite el bit de marca.

Bit de marca	SerCx2	SerCx	Serial.sys
SERIAL_EV_RXCHAR	Sí	Sí	Sí
SERIAL_EV_RXFLAG	Ver nota.	No	Sí
SERIAL_EV_TXEMPTY	Sí	Sí	Sí
SERIAL_EV_CTS	Sí	Sí	Sí
SERIAL_EV_DSR	Sí	Sí	Sí
SERIAL_EV_RLSD	Ver nota.	Sí	Sí
SERIAL_EV_BREAK	Sí	Sí	Sí
SERIAL_EV_ERR	Sí	Sí	Sí
SERIAL_EV_RING	Ver nota.	Sí	Sí
SERIAL_EV_PERR	Ver nota.	No	No
SERIAL_EV_RX80FULL	Ver nota.	No	Sí
SERIAL_EV_EVENT1	Ver nota.	No	No
SERIAL_EV_EVENT2	Ver nota.	No	No

Nota SerCx2 puede admitir o no el bit de marca en la entrada de tabla indicada, dependiendo del controlador de serie y de las funcionalidades del hardware del controlador serie.

Para obtener más información sobre SerCx2, SerCx y Serial.sys, consulte Información general sobre controladores de controlador serie.