696 lines
26 KiB
C
696 lines
26 KiB
C
/*++ BUILD Version: 0002 // Increment this if a change has global effects
|
|
|
|
Copyright (c) Microsoft Corporation. All rights reserved.
|
|
|
|
Module Name:
|
|
|
|
ntddser.h
|
|
|
|
Abstract:
|
|
|
|
This is the include file that defines all constants and types for
|
|
accessing the Serial device.
|
|
|
|
Author:
|
|
|
|
Steve Wood (stevewo) 27-May-1990
|
|
|
|
Revision History:
|
|
Louis J. Giliberto, Jr. (louisg) 28-Oct-97
|
|
|
|
--*/
|
|
|
|
|
|
//
|
|
// Interface GUIDs
|
|
//
|
|
// need these GUIDs outside conditional includes so that user can
|
|
// #include <ntddser.h> in precompiled header
|
|
// #include <initguid.h> in a single source file
|
|
// #include <ntddser.h> in that source file a second time to instantiate the GUIDs
|
|
//
|
|
#ifdef DEFINE_GUID
|
|
//
|
|
// Make sure FAR is defined...
|
|
//
|
|
#ifndef FAR
|
|
#ifdef _WIN32
|
|
#define FAR
|
|
#else
|
|
#define FAR _far
|
|
#endif
|
|
#endif
|
|
|
|
// begin_wioctlguids
|
|
DEFINE_GUID(GUID_DEVINTERFACE_COMPORT, 0x86e0d1e0L, 0x8089, 0x11d0, 0x9c, 0xe4, 0x08, 0x00, 0x3e, 0x30, 0x1f, 0x73);
|
|
DEFINE_GUID(GUID_DEVINTERFACE_SERENUM_BUS_ENUMERATOR, 0x4D36E978L, 0xE325, 0x11CE, 0xBF, 0xC1, 0x08, 0x00, 0x2B, 0xE1, 0x03, 0x18);
|
|
// end_wioctlguids
|
|
|
|
// begin_wioctlobsoleteguids
|
|
#define GUID_CLASS_COMPORT GUID_DEVINTERFACE_COMPORT
|
|
#define GUID_SERENUM_BUS_ENUMERATOR GUID_DEVINTERFACE_SERENUM_BUS_ENUMERATOR
|
|
// end_wioctlobsoleteguids
|
|
#endif // DEFINE_GUID
|
|
|
|
#ifndef _NTDDSER_
|
|
#define _NTDDSER_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
//
|
|
// NtDeviceIoControlFile IoControlCode values for this device.
|
|
//
|
|
|
|
#define IOCTL_SERIAL_SET_BAUD_RATE CTL_CODE(FILE_DEVICE_SERIAL_PORT, 1,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_QUEUE_SIZE CTL_CODE(FILE_DEVICE_SERIAL_PORT, 2,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_LINE_CONTROL CTL_CODE(FILE_DEVICE_SERIAL_PORT, 3,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_BREAK_ON CTL_CODE(FILE_DEVICE_SERIAL_PORT, 4,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_BREAK_OFF CTL_CODE(FILE_DEVICE_SERIAL_PORT, 5,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_IMMEDIATE_CHAR CTL_CODE(FILE_DEVICE_SERIAL_PORT, 6,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_TIMEOUTS CTL_CODE(FILE_DEVICE_SERIAL_PORT, 7,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_TIMEOUTS CTL_CODE(FILE_DEVICE_SERIAL_PORT, 8,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_DTR CTL_CODE(FILE_DEVICE_SERIAL_PORT, 9,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_CLR_DTR CTL_CODE(FILE_DEVICE_SERIAL_PORT,10,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_RESET_DEVICE CTL_CODE(FILE_DEVICE_SERIAL_PORT,11,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_RTS CTL_CODE(FILE_DEVICE_SERIAL_PORT,12,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_CLR_RTS CTL_CODE(FILE_DEVICE_SERIAL_PORT,13,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_XOFF CTL_CODE(FILE_DEVICE_SERIAL_PORT,14,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_XON CTL_CODE(FILE_DEVICE_SERIAL_PORT,15,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_WAIT_MASK CTL_CODE(FILE_DEVICE_SERIAL_PORT,16,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_WAIT_MASK CTL_CODE(FILE_DEVICE_SERIAL_PORT,17,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_WAIT_ON_MASK CTL_CODE(FILE_DEVICE_SERIAL_PORT,18,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_PURGE CTL_CODE(FILE_DEVICE_SERIAL_PORT,19,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_BAUD_RATE CTL_CODE(FILE_DEVICE_SERIAL_PORT,20,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_LINE_CONTROL CTL_CODE(FILE_DEVICE_SERIAL_PORT,21,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_CHARS CTL_CODE(FILE_DEVICE_SERIAL_PORT,22,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_CHARS CTL_CODE(FILE_DEVICE_SERIAL_PORT,23,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_HANDFLOW CTL_CODE(FILE_DEVICE_SERIAL_PORT,24,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_HANDFLOW CTL_CODE(FILE_DEVICE_SERIAL_PORT,25,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_MODEMSTATUS CTL_CODE(FILE_DEVICE_SERIAL_PORT,26,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_COMMSTATUS CTL_CODE(FILE_DEVICE_SERIAL_PORT,27,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_XOFF_COUNTER CTL_CODE(FILE_DEVICE_SERIAL_PORT,28,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_PROPERTIES CTL_CODE(FILE_DEVICE_SERIAL_PORT,29,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_DTRRTS CTL_CODE(FILE_DEVICE_SERIAL_PORT,30,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
|
|
//
|
|
// Serenum reserves function codes between 128 and 255. Do not use.
|
|
//
|
|
|
|
// begin_winioctl
|
|
|
|
#define IOCTL_SERIAL_LSRMST_INSERT CTL_CODE(FILE_DEVICE_SERIAL_PORT,31,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
|
|
#define IOCTL_SERENUM_EXPOSE_HARDWARE CTL_CODE(FILE_DEVICE_SERENUM,128,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERENUM_REMOVE_HARDWARE CTL_CODE(FILE_DEVICE_SERENUM,129,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERENUM_PORT_DESC CTL_CODE(FILE_DEVICE_SERENUM,130,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERENUM_GET_PORT_NAME CTL_CODE(FILE_DEVICE_SERENUM,131,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
|
|
// end_winioctl
|
|
|
|
#define IOCTL_SERIAL_CONFIG_SIZE CTL_CODE(FILE_DEVICE_SERIAL_PORT,32,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_COMMCONFIG CTL_CODE(FILE_DEVICE_SERIAL_PORT,33,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_COMMCONFIG CTL_CODE(FILE_DEVICE_SERIAL_PORT,34,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
|
|
#define IOCTL_SERIAL_GET_STATS CTL_CODE(FILE_DEVICE_SERIAL_PORT,35,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_CLEAR_STATS CTL_CODE(FILE_DEVICE_SERIAL_PORT,36,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_GET_MODEM_CONTROL CTL_CODE(FILE_DEVICE_SERIAL_PORT,37,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_MODEM_CONTROL CTL_CODE(FILE_DEVICE_SERIAL_PORT,38,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_SET_FIFO_CONTROL CTL_CODE(FILE_DEVICE_SERIAL_PORT,39,METHOD_BUFFERED,FILE_ANY_ACCESS)
|
|
|
|
|
|
//
|
|
// internal serial IOCTL's
|
|
//
|
|
|
|
#define IOCTL_SERIAL_INTERNAL_DO_WAIT_WAKE CTL_CODE(FILE_DEVICE_SERIAL_PORT, 1, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_INTERNAL_CANCEL_WAIT_WAKE CTL_CODE(FILE_DEVICE_SERIAL_PORT, 2, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS CTL_CODE(FILE_DEVICE_SERIAL_PORT, 3, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
#define IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS CTL_CODE(FILE_DEVICE_SERIAL_PORT, 4, METHOD_BUFFERED, FILE_ANY_ACCESS)
|
|
|
|
typedef struct _SERIALPERF_STATS {
|
|
ULONG ReceivedCount;
|
|
ULONG TransmittedCount;
|
|
ULONG FrameErrorCount;
|
|
ULONG SerialOverrunErrorCount;
|
|
ULONG BufferOverrunErrorCount;
|
|
ULONG ParityErrorCount;
|
|
} SERIALPERF_STATS, *PSERIALPERF_STATS;
|
|
|
|
typedef struct _SERIALCONFIG {
|
|
ULONG Size;
|
|
USHORT Version;
|
|
ULONG SubType;
|
|
ULONG ProvOffset;
|
|
ULONG ProviderSize;
|
|
WCHAR ProviderData[1];
|
|
} SERIALCONFIG,*PSERIALCONFIG;
|
|
|
|
//
|
|
// NtDeviceIoControlFile InputBuffer/OutputBuffer record structures for
|
|
// this device.
|
|
//
|
|
|
|
//
|
|
// This structure used to set line parameters.
|
|
//
|
|
|
|
typedef struct _SERIAL_LINE_CONTROL {
|
|
UCHAR StopBits;
|
|
UCHAR Parity;
|
|
UCHAR WordLength;
|
|
} SERIAL_LINE_CONTROL,*PSERIAL_LINE_CONTROL;
|
|
|
|
typedef struct _SERIAL_TIMEOUTS {
|
|
ULONG ReadIntervalTimeout;
|
|
ULONG ReadTotalTimeoutMultiplier;
|
|
ULONG ReadTotalTimeoutConstant;
|
|
ULONG WriteTotalTimeoutMultiplier;
|
|
ULONG WriteTotalTimeoutConstant;
|
|
} SERIAL_TIMEOUTS,*PSERIAL_TIMEOUTS;
|
|
|
|
//
|
|
// This structure used to resize the input/output buffers.
|
|
// An error code will be returned if the size exceeds the
|
|
// drivers capacity. The driver reserves the right to
|
|
// allocate a larger buffer.
|
|
//
|
|
|
|
typedef struct _SERIAL_QUEUE_SIZE {
|
|
ULONG InSize;
|
|
ULONG OutSize;
|
|
} SERIAL_QUEUE_SIZE,*PSERIAL_QUEUE_SIZE;
|
|
|
|
|
|
//
|
|
// This structure used by set baud rate
|
|
//
|
|
|
|
typedef struct _SERIAL_BAUD_RATE {
|
|
ULONG BaudRate;
|
|
} SERIAL_BAUD_RATE,*PSERIAL_BAUD_RATE;
|
|
|
|
|
|
|
|
//
|
|
// Defines the bitmask that the driver can used to notify
|
|
// app of various changes in the state of the UART.
|
|
//
|
|
|
|
#define SERIAL_EV_RXCHAR 0x0001 // Any Character received
|
|
#define SERIAL_EV_RXFLAG 0x0002 // Received certain character
|
|
#define SERIAL_EV_TXEMPTY 0x0004 // Transmitt Queue Empty
|
|
#define SERIAL_EV_CTS 0x0008 // CTS changed state
|
|
#define SERIAL_EV_DSR 0x0010 // DSR changed state
|
|
#define SERIAL_EV_RLSD 0x0020 // RLSD changed state
|
|
#define SERIAL_EV_BREAK 0x0040 // BREAK received
|
|
#define SERIAL_EV_ERR 0x0080 // Line status error occurred
|
|
#define SERIAL_EV_RING 0x0100 // Ring signal detected
|
|
#define SERIAL_EV_PERR 0x0200 // Printer error occured
|
|
#define SERIAL_EV_RX80FULL 0x0400 // Receive buffer is 80 percent full
|
|
#define SERIAL_EV_EVENT1 0x0800 // Provider specific event 1
|
|
#define SERIAL_EV_EVENT2 0x1000 // Provider specific event 2
|
|
|
|
//
|
|
// A longword is used to send down a mask that
|
|
// instructs the driver what to purge.
|
|
//
|
|
// SERIAL_PURGE_TXABORT - Implies the current and all pending writes.
|
|
// SERIAL_PURGE_RXABORT - Implies the current and all pending reads.
|
|
// SERIAL_PURGE_TXCLEAR - Implies the transmit buffer if exists
|
|
// SERIAL_PURGE_RXCLEAR - Implies the receive buffer if exists.
|
|
//
|
|
|
|
#define SERIAL_PURGE_TXABORT 0x00000001
|
|
#define SERIAL_PURGE_RXABORT 0x00000002
|
|
#define SERIAL_PURGE_TXCLEAR 0x00000004
|
|
#define SERIAL_PURGE_RXCLEAR 0x00000008
|
|
|
|
//
|
|
// Communication defines
|
|
//
|
|
|
|
#define STOP_BIT_1 0
|
|
#define STOP_BITS_1_5 1
|
|
#define STOP_BITS_2 2
|
|
|
|
#define NO_PARITY 0
|
|
#define ODD_PARITY 1
|
|
#define EVEN_PARITY 2
|
|
#define MARK_PARITY 3
|
|
#define SPACE_PARITY 4
|
|
|
|
|
|
//
|
|
// This structure is used to set and retrieve the special characters
|
|
// used by the nt serial driver.
|
|
//
|
|
// Note that the driver will return an error if xonchar == xoffchar.
|
|
//
|
|
|
|
typedef struct _SERIAL_CHARS {
|
|
UCHAR EofChar;
|
|
UCHAR ErrorChar;
|
|
UCHAR BreakChar;
|
|
UCHAR EventChar;
|
|
UCHAR XonChar;
|
|
UCHAR XoffChar;
|
|
} SERIAL_CHARS,*PSERIAL_CHARS;
|
|
|
|
//
|
|
// This structure is used to contain the flow control
|
|
// and handshaking setup.
|
|
//
|
|
// A reasonably precise explaination of how they all
|
|
// work can be found in the OS/2 tech references.
|
|
//
|
|
// For Xon/Xofflimit:
|
|
//
|
|
// When there are more characters then
|
|
//
|
|
// (typeaheadbuffersize - xofflimit)
|
|
//
|
|
// in the typeahead buffer then the driver will perform all flow
|
|
// control that the app has enabled so that the sender will (hopefully)
|
|
// stop sending characters.
|
|
//
|
|
// When there are less than xonlimit number of characters in the
|
|
// typeahead buffer the driver will perform all flow control that
|
|
// the app has enabled so that the sender will hopefully start sending
|
|
// characters again.
|
|
//
|
|
// It should be noted that if Xoff character is sent then the
|
|
// driver will also stop transmitting any more characters. This is to
|
|
// provide support for those systems that take any character that
|
|
// follows an Xoff as an implied Xon.
|
|
//
|
|
|
|
typedef struct _SERIAL_HANDFLOW {
|
|
ULONG ControlHandShake;
|
|
ULONG FlowReplace;
|
|
LONG XonLimit;
|
|
LONG XoffLimit;
|
|
} SERIAL_HANDFLOW,*PSERIAL_HANDFLOW;
|
|
|
|
#define SERIAL_DTR_MASK ((ULONG)0x03)
|
|
#define SERIAL_DTR_CONTROL ((ULONG)0x01)
|
|
#define SERIAL_DTR_HANDSHAKE ((ULONG)0x02)
|
|
#define SERIAL_CTS_HANDSHAKE ((ULONG)0x08)
|
|
#define SERIAL_DSR_HANDSHAKE ((ULONG)0x10)
|
|
#define SERIAL_DCD_HANDSHAKE ((ULONG)0x20)
|
|
#define SERIAL_OUT_HANDSHAKEMASK ((ULONG)0x38)
|
|
#define SERIAL_DSR_SENSITIVITY ((ULONG)0x40)
|
|
#define SERIAL_ERROR_ABORT ((ULONG)0x80000000)
|
|
#define SERIAL_CONTROL_INVALID ((ULONG)0x7fffff84)
|
|
#define SERIAL_AUTO_TRANSMIT ((ULONG)0x01)
|
|
#define SERIAL_AUTO_RECEIVE ((ULONG)0x02)
|
|
#define SERIAL_ERROR_CHAR ((ULONG)0x04)
|
|
#define SERIAL_NULL_STRIPPING ((ULONG)0x08)
|
|
#define SERIAL_BREAK_CHAR ((ULONG)0x10)
|
|
#define SERIAL_RTS_MASK ((ULONG)0xc0)
|
|
#define SERIAL_RTS_CONTROL ((ULONG)0x40)
|
|
#define SERIAL_RTS_HANDSHAKE ((ULONG)0x80)
|
|
#define SERIAL_TRANSMIT_TOGGLE ((ULONG)0xc0)
|
|
#define SERIAL_XOFF_CONTINUE ((ULONG)0x80000000)
|
|
#define SERIAL_FLOW_INVALID ((ULONG)0x7fffff20)
|
|
|
|
//
|
|
// These are the following reasons that the device could be holding.
|
|
//
|
|
#define SERIAL_TX_WAITING_FOR_CTS ((ULONG)0x00000001)
|
|
#define SERIAL_TX_WAITING_FOR_DSR ((ULONG)0x00000002)
|
|
#define SERIAL_TX_WAITING_FOR_DCD ((ULONG)0x00000004)
|
|
#define SERIAL_TX_WAITING_FOR_XON ((ULONG)0x00000008)
|
|
#define SERIAL_TX_WAITING_XOFF_SENT ((ULONG)0x00000010)
|
|
#define SERIAL_TX_WAITING_ON_BREAK ((ULONG)0x00000020)
|
|
#define SERIAL_RX_WAITING_FOR_DSR ((ULONG)0x00000040)
|
|
|
|
//
|
|
// These are the error values that can be returned by the
|
|
// driver.
|
|
//
|
|
#define SERIAL_ERROR_BREAK ((ULONG)0x00000001)
|
|
#define SERIAL_ERROR_FRAMING ((ULONG)0x00000002)
|
|
#define SERIAL_ERROR_OVERRUN ((ULONG)0x00000004)
|
|
#define SERIAL_ERROR_QUEUEOVERRUN ((ULONG)0x00000008)
|
|
#define SERIAL_ERROR_PARITY ((ULONG)0x00000010)
|
|
|
|
|
|
//
|
|
// This structure is used by IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS
|
|
// and IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS
|
|
//
|
|
|
|
typedef struct _SERIAL_BASIC_SETTINGS {
|
|
SERIAL_TIMEOUTS Timeouts;
|
|
SERIAL_HANDFLOW HandFlow;
|
|
ULONG RxFifo;
|
|
ULONG TxFifo;
|
|
} SERIAL_BASIC_SETTINGS, *PSERIAL_BASIC_SETTINGS;
|
|
|
|
|
|
//
|
|
// This structure is used to get the current error and
|
|
// general status of the driver.
|
|
//
|
|
|
|
typedef struct _SERIAL_STATUS {
|
|
ULONG Errors;
|
|
ULONG HoldReasons;
|
|
ULONG AmountInInQueue;
|
|
ULONG AmountInOutQueue;
|
|
BOOLEAN EofReceived;
|
|
BOOLEAN WaitForImmediate;
|
|
} SERIAL_STATUS,*PSERIAL_STATUS;
|
|
|
|
//
|
|
// This structure is used for XOFF counter ioctl. The xoff ioctl
|
|
// is used to support those subsystems that feel the need to emulate
|
|
// the serial chip in software.
|
|
//
|
|
// It has the following semantics:
|
|
//
|
|
// This io request is placed into the normal device write
|
|
// queue. That is, it will be queued behind any writes
|
|
// already given to the driver.
|
|
//
|
|
// When this request becomes the current request, the character
|
|
// specified in the field XoffChar will be sent, subject to
|
|
// all other flow control already defined.
|
|
//
|
|
// Immediately upon sending the character the driver will
|
|
// perform the following actions.
|
|
//
|
|
// A timer will be initiated that will expire after the
|
|
// number of milliseconds in the Timeout field of the
|
|
// SERIAL_XOFF_COUNTER structure.
|
|
//
|
|
// The driver will initialize a counter to the value specified
|
|
// in the Counter field of the SERIAL_XOFF_RECORD. The driver
|
|
// will decrement this counter whenever a character is received.
|
|
//
|
|
// This request will then be held by the driver. It will
|
|
// actually complete under the following circumstances:
|
|
//
|
|
// 1) If there is another "write" request behind it in the queue.
|
|
// The "xoff" request will be completed with the informational status
|
|
// STATUS_SERIAL_MORE_WRITES. The Information field of the
|
|
// IOSTATUS block will be set to 0.
|
|
//
|
|
// Note: By write request we mean another SERIAL_XOFF_COUNTER
|
|
// request, or a simple write request. If the only subsequent
|
|
// request is a flush request, the driver WILL NOT automatically
|
|
// complete the SERIAL_XOFF_COUNTER request. NOTE: Transmit
|
|
// immediate requests DO NOT count as a normal write, and therefore
|
|
// would not cause a counter request to complete.
|
|
//
|
|
// 2) The timer expires. The driver will complete the request
|
|
// with the informational status STATUS_SERIAL_COUNTER_TIMEOUT.
|
|
// The Information field of the IOSTATUS of the request will be set to 0.
|
|
//
|
|
// 3) The driver maintained counter goes to zero. (By implication,
|
|
// at least "Counter" number of characters have been received.)
|
|
// The request will be completed with a successful status
|
|
// of STATUS_SUCCESS. The Information field of the
|
|
// IOSTATUS of the request will be set to 0.
|
|
//
|
|
// 4) This is really a degenerate case of "1" above. The request
|
|
// is started and no request follow it on the queue. However
|
|
// at some point, before "2" or "3" above occur, another "write"
|
|
// request is started. This will cause the completion actions
|
|
// stated in "1" to occur.
|
|
//
|
|
// NOTE: This request being issued WILL NOT cause the normal flow
|
|
// control code of the driver to be invoked.
|
|
//
|
|
// NOTE: This request has no interaction with the IOCTL_SERIAL_WAIT_ON_MASK
|
|
// request. An application CAN NOT wait via the above ^^^^^^ ioctl
|
|
// on the counter going to zero. The application must synchronize
|
|
// with the particular IOCTL_SERIAL_XOFF_COUNTER request.
|
|
//
|
|
// NOTE: The Timeout value equal to zero would cause the counter
|
|
// to NEVER timeout. The only way that such a request could
|
|
// be killed at that point would be issue another write, or
|
|
// to purge the WRITE queue.
|
|
//
|
|
|
|
typedef struct _SERIAL_XOFF_COUNTER {
|
|
ULONG Timeout; // Zero based. In milliseconds
|
|
LONG Counter; // Must be greater than zero.
|
|
UCHAR XoffChar;
|
|
} SERIAL_XOFF_COUNTER,*PSERIAL_XOFF_COUNTER;
|
|
|
|
//
|
|
// The following structure (and defines) are passed back by
|
|
// the serial driver in response to the get properties ioctl.
|
|
//
|
|
|
|
#define SERIAL_SP_SERIALCOMM ((ULONG)0x00000001)
|
|
|
|
//
|
|
// Provider subtypes
|
|
//
|
|
#define SERIAL_SP_UNSPECIFIED ((ULONG)0x00000000)
|
|
#define SERIAL_SP_RS232 ((ULONG)0x00000001)
|
|
#define SERIAL_SP_PARALLEL ((ULONG)0x00000002)
|
|
#define SERIAL_SP_RS422 ((ULONG)0x00000003)
|
|
#define SERIAL_SP_RS423 ((ULONG)0x00000004)
|
|
#define SERIAL_SP_RS449 ((ULONG)0x00000005)
|
|
#define SERIAL_SP_MODEM ((ULONG)0X00000006)
|
|
#define SERIAL_SP_FAX ((ULONG)0x00000021)
|
|
#define SERIAL_SP_SCANNER ((ULONG)0x00000022)
|
|
#define SERIAL_SP_BRIDGE ((ULONG)0x00000100)
|
|
#define SERIAL_SP_LAT ((ULONG)0x00000101)
|
|
#define SERIAL_SP_TELNET ((ULONG)0x00000102)
|
|
#define SERIAL_SP_X25 ((ULONG)0x00000103)
|
|
|
|
//
|
|
// Provider capabilities flags.
|
|
//
|
|
|
|
#define SERIAL_PCF_DTRDSR ((ULONG)0x0001)
|
|
#define SERIAL_PCF_RTSCTS ((ULONG)0x0002)
|
|
#define SERIAL_PCF_CD ((ULONG)0x0004)
|
|
#define SERIAL_PCF_PARITY_CHECK ((ULONG)0x0008)
|
|
#define SERIAL_PCF_XONXOFF ((ULONG)0x0010)
|
|
#define SERIAL_PCF_SETXCHAR ((ULONG)0x0020)
|
|
#define SERIAL_PCF_TOTALTIMEOUTS ((ULONG)0x0040)
|
|
#define SERIAL_PCF_INTTIMEOUTS ((ULONG)0x0080)
|
|
#define SERIAL_PCF_SPECIALCHARS ((ULONG)0x0100)
|
|
#define SERIAL_PCF_16BITMODE ((ULONG)0x0200)
|
|
|
|
//
|
|
// Comm provider settable parameters.
|
|
//
|
|
|
|
#define SERIAL_SP_PARITY ((ULONG)0x0001)
|
|
#define SERIAL_SP_BAUD ((ULONG)0x0002)
|
|
#define SERIAL_SP_DATABITS ((ULONG)0x0004)
|
|
#define SERIAL_SP_STOPBITS ((ULONG)0x0008)
|
|
#define SERIAL_SP_HANDSHAKING ((ULONG)0x0010)
|
|
#define SERIAL_SP_PARITY_CHECK ((ULONG)0x0020)
|
|
#define SERIAL_SP_CARRIER_DETECT ((ULONG)0x0040)
|
|
|
|
//
|
|
// Settable baud rates in the provider.
|
|
//
|
|
|
|
#define SERIAL_BAUD_075 ((ULONG)0x00000001)
|
|
#define SERIAL_BAUD_110 ((ULONG)0x00000002)
|
|
#define SERIAL_BAUD_134_5 ((ULONG)0x00000004)
|
|
#define SERIAL_BAUD_150 ((ULONG)0x00000008)
|
|
#define SERIAL_BAUD_300 ((ULONG)0x00000010)
|
|
#define SERIAL_BAUD_600 ((ULONG)0x00000020)
|
|
#define SERIAL_BAUD_1200 ((ULONG)0x00000040)
|
|
#define SERIAL_BAUD_1800 ((ULONG)0x00000080)
|
|
#define SERIAL_BAUD_2400 ((ULONG)0x00000100)
|
|
#define SERIAL_BAUD_4800 ((ULONG)0x00000200)
|
|
#define SERIAL_BAUD_7200 ((ULONG)0x00000400)
|
|
#define SERIAL_BAUD_9600 ((ULONG)0x00000800)
|
|
#define SERIAL_BAUD_14400 ((ULONG)0x00001000)
|
|
#define SERIAL_BAUD_19200 ((ULONG)0x00002000)
|
|
#define SERIAL_BAUD_38400 ((ULONG)0x00004000)
|
|
#define SERIAL_BAUD_56K ((ULONG)0x00008000)
|
|
#define SERIAL_BAUD_128K ((ULONG)0x00010000)
|
|
#define SERIAL_BAUD_115200 ((ULONG)0x00020000)
|
|
#define SERIAL_BAUD_57600 ((ULONG)0x00040000)
|
|
#define SERIAL_BAUD_USER ((ULONG)0x10000000)
|
|
|
|
//
|
|
// Settable Data Bits
|
|
//
|
|
|
|
#define SERIAL_DATABITS_5 ((USHORT)0x0001)
|
|
#define SERIAL_DATABITS_6 ((USHORT)0x0002)
|
|
#define SERIAL_DATABITS_7 ((USHORT)0x0004)
|
|
#define SERIAL_DATABITS_8 ((USHORT)0x0008)
|
|
#define SERIAL_DATABITS_16 ((USHORT)0x0010)
|
|
#define SERIAL_DATABITS_16X ((USHORT)0x0020)
|
|
|
|
//
|
|
// Settable Stop and Parity bits.
|
|
//
|
|
|
|
#define SERIAL_STOPBITS_10 ((USHORT)0x0001)
|
|
#define SERIAL_STOPBITS_15 ((USHORT)0x0002)
|
|
#define SERIAL_STOPBITS_20 ((USHORT)0x0004)
|
|
#define SERIAL_PARITY_NONE ((USHORT)0x0100)
|
|
#define SERIAL_PARITY_ODD ((USHORT)0x0200)
|
|
#define SERIAL_PARITY_EVEN ((USHORT)0x0400)
|
|
#define SERIAL_PARITY_MARK ((USHORT)0x0800)
|
|
#define SERIAL_PARITY_SPACE ((USHORT)0x1000)
|
|
|
|
typedef struct _SERIAL_COMMPROP {
|
|
USHORT PacketLength;
|
|
USHORT PacketVersion;
|
|
ULONG ServiceMask;
|
|
ULONG Reserved1;
|
|
ULONG MaxTxQueue;
|
|
ULONG MaxRxQueue;
|
|
ULONG MaxBaud;
|
|
ULONG ProvSubType;
|
|
ULONG ProvCapabilities;
|
|
ULONG SettableParams;
|
|
ULONG SettableBaud;
|
|
USHORT SettableData;
|
|
USHORT SettableStopParity;
|
|
ULONG CurrentTxQueue;
|
|
ULONG CurrentRxQueue;
|
|
ULONG ProvSpec1;
|
|
ULONG ProvSpec2;
|
|
WCHAR ProvChar[1];
|
|
} SERIAL_COMMPROP,*PSERIAL_COMMPROP;
|
|
|
|
//
|
|
// Define masks for the rs-232 input and output.
|
|
//
|
|
|
|
#define SERIAL_DTR_STATE ((ULONG)0x00000001)
|
|
#define SERIAL_RTS_STATE ((ULONG)0x00000002)
|
|
#define SERIAL_CTS_STATE ((ULONG)0x00000010)
|
|
#define SERIAL_DSR_STATE ((ULONG)0x00000020)
|
|
#define SERIAL_RI_STATE ((ULONG)0x00000040)
|
|
#define SERIAL_DCD_STATE ((ULONG)0x00000080)
|
|
|
|
|
|
// begin_winioctl
|
|
|
|
//
|
|
// The following values follow the escape designator in the
|
|
// data stream if the LSRMST_INSERT mode has been turned on.
|
|
//
|
|
#define SERIAL_LSRMST_ESCAPE ((UCHAR)0x00)
|
|
|
|
//
|
|
// Following this value is the contents of the line status
|
|
// register, and then the character in the RX hardware when
|
|
// the line status register was encountered.
|
|
//
|
|
#define SERIAL_LSRMST_LSR_DATA ((UCHAR)0x01)
|
|
|
|
//
|
|
// Following this value is the contents of the line status
|
|
// register. No error character follows
|
|
//
|
|
#define SERIAL_LSRMST_LSR_NODATA ((UCHAR)0x02)
|
|
|
|
//
|
|
// Following this value is the contents of the modem status
|
|
// register.
|
|
//
|
|
#define SERIAL_LSRMST_MST ((UCHAR)0x03)
|
|
|
|
//
|
|
// Bit values for FIFO Control Register
|
|
//
|
|
|
|
#define SERIAL_IOC_FCR_FIFO_ENABLE ((ULONG)0x00000001)
|
|
#define SERIAL_IOC_FCR_RCVR_RESET ((ULONG)0x00000002)
|
|
#define SERIAL_IOC_FCR_XMIT_RESET ((ULONG)0x00000004)
|
|
#define SERIAL_IOC_FCR_DMA_MODE ((ULONG)0x00000008)
|
|
#define SERIAL_IOC_FCR_RES1 ((ULONG)0x00000010)
|
|
#define SERIAL_IOC_FCR_RES2 ((ULONG)0x00000020)
|
|
#define SERIAL_IOC_FCR_RCVR_TRIGGER_LSB ((ULONG)0x00000040)
|
|
#define SERIAL_IOC_FCR_RCVR_TRIGGER_MSB ((ULONG)0x00000080)
|
|
|
|
//
|
|
// Bit values for Modem Control Register
|
|
//
|
|
|
|
#define SERIAL_IOC_MCR_DTR ((ULONG)0x00000001)
|
|
#define SERIAL_IOC_MCR_RTS ((ULONG)0x00000002)
|
|
#define SERIAL_IOC_MCR_OUT1 ((ULONG)0x00000004)
|
|
#define SERIAL_IOC_MCR_OUT2 ((ULONG)0x00000008)
|
|
#define SERIAL_IOC_MCR_LOOP ((ULONG)0x00000010)
|
|
|
|
// end_winioctl
|
|
|
|
//
|
|
// Serenum internal ioctl's
|
|
//
|
|
|
|
#undef PHYSICAL_ADDRESS
|
|
#define PHYSICAL_ADDRESS LARGE_INTEGER
|
|
|
|
typedef struct _SERENUM_PORT_DESC
|
|
{
|
|
IN ULONG Size; // sizeof (struct _PORT_DESC)
|
|
OUT PVOID PortHandle;
|
|
OUT PHYSICAL_ADDRESS PortAddress;
|
|
USHORT Reserved[1];
|
|
} SERENUM_PORT_DESC, * PSERENUM_PORT_DESC;
|
|
|
|
// **************************************************************************
|
|
// Internal IOCTL interface for (pdo)
|
|
// The HID to legacy serial port minidriver uses this interface to
|
|
// find the address of the device.
|
|
// **************************************************************************
|
|
|
|
#define IOCTL_INTERNAL_SERENUM_REMOVE_SELF \
|
|
CTL_CODE(FILE_DEVICE_SERENUM, 129, METHOD_NEITHER, FILE_ANY_ACCESS)
|
|
|
|
|
|
// of which IO_STACK_LOCATION->Parameters.Others.Argument1 is set to
|
|
// a pointer to struct _SERENUM_SER_PARAMETERS
|
|
|
|
typedef
|
|
UCHAR
|
|
(*PSERENUM_READPORT) (
|
|
PVOID SerPortAddress
|
|
);
|
|
|
|
typedef
|
|
VOID
|
|
(*PSERENUM_WRITEPORT) (
|
|
PVOID SerPortAddress,
|
|
UCHAR Value
|
|
);
|
|
|
|
typedef enum _SERENUM_PORTION {
|
|
SerenumFirstHalf,
|
|
SerenumSecondHalf,
|
|
SerenumWhole
|
|
} SERENUM_PORTION;
|
|
|
|
typedef struct _SERENUM_PORT_PARAMETERS
|
|
{
|
|
IN ULONG Size; // sizeof (SERENUM_GET_PORT_PARAMETERS)
|
|
|
|
OUT PSERENUM_READPORT ReadAccessor; // read the serial port
|
|
OUT PSERENUM_WRITEPORT WriteAccessor; // write the serial port
|
|
OUT PVOID SerPortAddress; // token to read this serial port
|
|
|
|
OUT PVOID HardwareHandle; // a handle to this particular PDO.
|
|
OUT SERENUM_PORTION Portion;
|
|
OUT USHORT NumberAxis; // legacy joysticks only
|
|
USHORT Reserved [3];
|
|
} SERENUM_PORT_PARAMETERS, *PSERENUM_PORT_PARAMETERS;
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // _NTDDSER_
|
|
|