_HARDWAREINFO
typedef struct {
DWORD ddCom_Port;
DWORD com_base;
DWORD ddIRQ_Number;
DWORD ddPauseTime;
DWORD ddReserved;
DWORD ddOrientation;
DRV_CALBSTRUCT calibrate;
DWORD ddBufferZoneX;
DWORD ddBufferZoneY;
DWORD ddHardwarePacketSize;
DWORD ddComPortSettings;
DWORD dwHwFlags;
DWORD ddHardwareType;
DWORD ddTimerTickRate;
DWORD ddDelayTime;
DWORD ddVpenD_IRQ_Handle;
DWORD ddSystemVMHandle;
} _HARDWAREINFO;
The hardware information structure is used by the virtual pen driver for hardware-specific information. The pen driver does not use this structure.
- ddCom_Port
- The COM port number used by the pen hardware. ddCom_Port is 0 if the hardware does not use a COM port, 1 for COM 1, 2 for COM 2, etc.
- com_base
- If ddCom_Port does not equal zero, com_base contains the base I/O address (in hexadecimal) that the port uses. For instance, the COM1 base I/O address is 3F8.
- ddIRQ_Number
- The IRQ number that the system uses. For instance, for COM1, the typical IRQ number is 4.
- ddPauseTime
- Time required to reset the digitizer during initialization.
- ddReserved
- Not used. Should be set to zero.
- ddOrientation
- Screen orientation. ddOrientation is an integer value from 0 to 3.
- calibrate
- A DRV_CALBSTRUCT structure that contains the current calibration information. The DRV_GetCalibration message is used to fill the DRV_CALBSTRUCT structure with calibration information.
- ddBufferZoneX
- Represents the number of units (in 0.001 inch) to reduce the active area in the x-direction. ddBufferZoneX applies only to opaque tablets. Creating a buffer zone around the edge of the active area makes it easier for the user to move the pen to the edge of the screen.
- ddBufferZoneY
- Represents the number of units (in 0.001 inch) to reduce the active area in the y-direction. See the definition of the ddBufferZoneX member for more information.
- ddHardwarePacketSize
- The number of bytes the serial device sends before the driver has received a complete pen packet.
- ddComPortSettings
- Defines the baud, parity, data, and stop bits of the serial transmission. The high-order word is baud divisor based on 19200. For example, 1 indicates 19200 and 2 indicates 9600. The low-order word is the control register values for parity, data, and stop bits.
- dwHwFlags
- A bitwise-OR combination of hardware flags. The hardware capability flag constants used by the sample pen virtual driver are defined in the in PENDRV.H.
- ddHardwareType
- Denotes the type of hardware. The hardware capability flag constants HW_PUSHMODEL and HW_TIMERMODEL in PENDRV.H define the types of hardware used by the sample pen driver. For more information, see About the Virtual Pen Driver.
- ddTimerTickRate
- Sets the rate in timer ticks at which the callback function receives control. For more information, see About the Virtual Pen Driver.
- ddDelayTime
- Sets the amount of time (in milliseconds) that must elapse waiting for a hardware interrupt before generating events from a timer tick. If ddDelayTime milliseconds elapse without receiving a hardware event, the VxD assumes the pen has moved beyond the tablet's range of sensitivity or has stopped moving. For more information, see About the Virtual Pen Driver.
- ddVpenD_IRQ_Handle
- The IRQ handle.
- ddSystemVMHandle
- The system VM handle.