_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.