IOCTL_SERIAL_WAIT_ON_MASK (Windows CE 5.0)
This IOCTL instructs a serial driver to wait for a communications event that matches the event specified in the event mask. The DeviceIoControl function executes this IOCTL.
Parameters
- dwOpenData
[in] Handle returned from a call to the COM_Open function. - dwCode
[in] Set to this IOCTL: IOCTL_SERIAL_WAIT_ON_MASK. - pBufIn
Ignored. - dwLenIn
Ignored. - pBufOut
[out] Pointer to a DWORD variable to place the event mask. The returned mask shows the event that terminated the wait event. If a process attempts to change the device handle's event mask by using IOCTL_SERIAL_SET_WAIT_MASK, the driver should return immediately with an empty event mask. - dwLenOut
[out] Greater than or equal to sizeof(DWORD). - pdwActualOut
[out] Pointer to a DWORD variable to return the length of the returned data. If there is no error, pdwActualOut should be set to sizeof(DWORD).
Return Values
Returns TRUE if successful. Returns FALSE otherwise. To get extended error information, call GetLastError.
Remarks
The returned mask shows the event that terminated the wait. If a process attempts to change the device handle's event mask by using the IOCTL_SERIAL_SET_WAIT_MASK call, the driver should return immediately with (DWORD)0 as the returned event mask.
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Pegdser.h.
See Also
COM_IOControl | COM_Open | DeviceIoControl | IOCTL_SERIAL_GET_WAIT_MASK | IOCTL_SERIAL_SET_WAIT_MASK
Send Feedback on this topic to the authors