IOCTL_SERIAL_SET_WAIT_MASK IOCTL (ntddser.h)
The IOCTL_SERIAL_SET_WAIT_MASK request configures the serial controller driver to notify a client after the occurrence of any one of a specified set of wait events.
A client can wait for the wait events represented by flag bits SERIAL_EV_RXCHAR through SERIAL_EV_EVENT2. For more information about these event flags, see the Remarks section.
A client specifies wait events by setting an input event wait mask to the bitwise-OR of one or more of the event flags. A client can clear all wait events by setting the input event wait mask to zero.
A client uses an IOCTL_SERIAL_WAIT_ON_MASK request to wait for the occurrence of a wait event. If a wait-on-mask request is already pending when a set-wait-mask request is processed, the pending wait-on-event request is completed with a status of STATUS_SUCCESS and the output wait event mask is set to zero.
Major code
Input buffer
The AssociatedIrp.SystemBuffer member points to a ULONG buffer that the client allocates and sets to an event wait mask. The wait mask is set to zero or to the bitwise-OR of one or more SERIAL_EV_XXX flags bits.
Input buffer length
The Parameters.DeviceIoControl.InputBufferLength member is set to the size, in bytes, of a ULONG.
Output buffer
None.
Output buffer length
None.
Status block
The Information member is set to zero.
The Status member is set to one of the Generic Status Values for Serial Device Control Requests. A status of STATUS_INVALID_PARAMETER indicates that the input wait mask is not valid.
Remarks
The SERIAL_EV_XXX constants define the flag bits in the wait mask for a serial port.
#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
The SERIAL_EV_XXX constants define the types of events that can be specified in a wait mask. After a client (application or peripheral driver) opens a connection to a serial port, the client can specify a wait mask that indicates the types of events that the client needs to monitor. These events are changes in the hardware state of the serial port. When an event in the wait mask occurs, the client is notified.
The IOCTL_SERIAL_SET_WAIT_MASK and IOCTL_SERIAL_GET_WAIT_MASK control requests use event wait masks to specify a set of events on which a client can wait. A wait mask value is either zero or the bitwise-OR of one or more SERIAL_EV_XXX constants. A wait mask value of zero indicates that the client is not waiting for any events.
The client sends an IOCTL_SERIAL_WAIT_ON_MASK control request to wait for an event in the currently set wait mask. The serial controller driver completes this request when an event in the wait mask occurs.
The following table shows which SERIAL_EV_XXX flag bits are supported by SerCx2, SerCx, and Serial.sys. A Yes entry in the table indicates that the serial framework extension or driver supports the corresponding flag bit. A No entry indicates that the flag bit is not supported.
| Flag bit | SerCx2 | SerCx | Serial.sys |
|---|---|---|---|
| SERIAL_EV_RXCHAR | Yes | Yes | Yes |
| SERIAL_EV_RXFLAG | See note. | No | Yes |
| SERIAL_EV_TXEMPTY | Yes | Yes | Yes |
| SERIAL_EV_CTS | Yes | Yes | Yes |
| SERIAL_EV_DSR | Yes | Yes | Yes |
| SERIAL_EV_RLSD | See note. | Yes | Yes |
| SERIAL_EV_BREAK | Yes | Yes | Yes |
| SERIAL_EV_ERR | Yes | Yes | Yes |
| SERIAL_EV_RING | See note. | Yes | Yes |
| SERIAL_EV_PERR | See note. | No | No |
| SERIAL_EV_RX80FULL | See note. | No | Yes |
| SERIAL_EV_EVENT1 | See note. | No | No |
| SERIAL_EV_EVENT2 | See note. | No | No |
Requirements
| Requirement | Value |
|---|---|
| Header | ntddser.h (include Ntddser.h) |