Share via


IOCTL_SERIAL_GET_COMMSTATUS

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This IOCTL clears pending communications errors and returns the current communication status. 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_GET_COMMSTATUS.
  • pBufIn
    Ignored.
  • dwLenIn
    Ignored.
  • pBufOut
    [out] Pointer to a SERIAL_DEV_STATUS structure to contain the returned status information.
  • dwLenOut
    [out] Greater than or equal to sizeof(SERIAL_DEV_STATUS).
  • pdwActualOut
    [out] Pointer to a DWORD variable to return the length of the returned data. Set to sizeof(SERIAL_DEV_STATUS) if there is no error.

Return Values

Returns TRUE if successful. Returns FALSE otherwise. To get extended error information, call GetLastError.

Requirements

Header pegdser.h
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

COM_Open
DeviceIoControl
SERIAL_DEV_STATUS