1 概要

1.1 Wintabとは

1.2 Intuosシリーズ

1.3 アプリケーションの変更点

2 Wintabの初期化とデータ

2.1 プログラムヘッダーでの注意

2.2 Wintabの存在確認

2.3 Wintabの初期化

3 一般的な座標データ入力方法

3.1 メッセージによるデバイス情報の取得

3.2 ポーリングによるデバイス情報の取得

3.3 アクティブ／非アクティブ時の処理

3.4 システムコンテキストとデジタイザコンテキストの併用

4 各種タブレット情報の取得

4.1 パケットの宣言

4.2 パケットの構成

4.3 カーソル情報

4.4 ボタン情報

4.5 座標データ

4.6 筆圧情報

4.7 傾き情報

4.8 回転情報（４Ｄマウスのホイール情報）

5 その他の情報

5.1 IntuosシリーズにおけるデバイスＩＤの求め方

5.2 イレーサの識別方法

5.3 データの最大値、最小値の求め方

5.4 タブレット座標データの最大最小と分解能を知る

5.5 使っているタブレットで利用可能なデバイスの種類を知る方法

5.6 Out of Bounds Trackingの設定

5.7 パケットデータキューのサイズを変更する

5.8 Wintabバージョンを識別する

6 関数リファレンス

6.1 基本的な関数

6.1.1. WTInfo

6.1.2. WTOpen

6.1.3. WTClose

6.1.4. WTPacketsGet

6.1.5. WTPacket

6.2 可視化関数

6.2.1. WTEnable

6.2.2. WTOverlap

6.3 コンテキスト編集関数

6.3.1. WTGet

6.3.2. WTSet（1.1変更）

6.3.3. WTExtGet

6.3.4. WTExtSet

6.3.5. WTSave

6.3.6. WTRestore

6.4 高度なパケットおよびキュー関数

6.4.1. WTPacketsPeek

6.4.2. WTDataGet

6.4.3. WTDataPeek

6.4.4. WTQueuePackets（16ビットのみ）

6.4.5. WTQueuePacketsEx

6.4.6. WTQueueSizeGet

6.4.7. TQueueSizeSet

6.5 マネージャーハンドル関数

6.5.1. WTMgrOpen

6.5.2. WTMgrClose

6.6 マネージャーコンテキスト関数

6.6.1. WTMgrContextEnum

6.6.2. WTMgrContextOwner

6.6.3. WTMgrDefContext

6.6.4. WTMgrDefContextEx（1.1変更、1.4変更）

6.7 マネージャーのユーザ設定データ関数（1.4変更）

6.7.1. WTMgrCsrButtonMap

6.7.2. WTMgrCsrPressureBtnMarks（16ビットのみ）

6.7.3. WTMgrCsrPressureBtnMarksEx

6.7.4. WTMgrCsrPressureResponse

7 メッセージリファレンス

7.1 イベントメッセージ

7.1.1. WT_PACKET

7.1.2. WT_CSRCHANGE (1.1)

7.2 コンテキストメッセージ

7.2.1. WT_CTXOPEN

7.2.2. WT_CTXCLOSE

7.2.3. WT_CTXUPDATE

7.2.4. WT_CTXOVERLAP

7.2.5. WT_PROXIMITY

7.3. 情報変更メッセージ

7.3.1. WT_INFOCHANGE（1.4変更）

8 データリファレンス

8.1 一般的なデータ型（1.1変更、1.4変更）

8.2 情報データ構造体

8.2.1. AXIS

8.2.2. 情報カテゴリおよびインデックス（1.1変更）

8.3 コンテキストデータ構造体

8.3.1. LOGCONTEXT（1.1変更）

8.4 イベントデータ構造体

8.4.1. PACKET（1.1変更）

8.4.2. ORIENTATION

8.4.3. ROTATION (1.1)

付録A. PKTDEF.Hの使用

付録B. 拡張定義（1.4変更）

B.1 拡張プログラミング

拡張のプログラミングノート

B.2 OUT OF BOUNDS TRACKING（境界外トラッキング）

OBTプログラミング

情報カテゴリー

OBTのオンまたはオフ

B.5 カーソルマスク

CSRMASKプログラミング

情報カテゴリー

B.7 EXPRESS KEYS（ファンクションキー）拡張（1.4変更）

B.8 TOUCH STRIPS（トラックパッド）およびTOUCH RINGS（タッチホイール）拡張（1.4変更）

B.9 拡張の構造（1.4変更）

EXPKEYSDATA構造体

SLIDERDATA構造体

EXTPROPERTY構造体

付録C. 追加機能（1.4変更）

c.1 消しゴム

c.2 傾き検出

c.3 DUAL TRACK

c.4 UNIQUE ID

c.5 エアブラシ FINGERWHEEL

c.6 4D マウス 回転

c.7 4D マウス サムホイール

1. アプリケーション起動時にWintabの初期化を行う

   まず、WTInfo()関数で、タブレットが利用可能か確認します［2.2］。
   同じくWTInfo()関数でタブレットの基本情報を取得、この基本情報を元にWTInfo()関数でアプリケーションに合ったタブレット環境を設定します［2.3］。タブレット情報はマウス情報に比べ情報量が多いのでWintabデータキューがオーバーフローする場合があります。そのためアプリケーションの処理内容にあわせ、適当なキューサイズをWTQueueSizeSet()関数で設定しておくこともできます。［5.6］

2. イベントハンドラ

   タブレットのデータを取り込むタイミングが重要になります。デバイスの操作をすばやく取り込んでアプリケーションに生かすには、次のイベントメッセージを利用する方法があります。
   

   • WM_LBUTTONDOWN / WM_LBUTTONUP

     マウスのボタンダウン、アップ、デバイスのスイッチON/OFFでこのメッセージを受け取ることができます。通常、WM_LBUTTONDOWNを受け取ってからWM_LBUTTONUPを受け取るまでずっとペンダウン状態であるとみなして、WTPacketsGet()関数でデータキューにたまっている情報を取り続けるようにすることで描画処理を行うこともできます。
     マウスイベントとWintabパケットは同期していませんので、プログラミングに際しては少し工夫が必要です。例えば、 WM_LBUTTONDOWNを受け取った時、Wintabのデータキューにはまだスイッチが入っていない時の情報が残っていますので、これらを全て整理してスイッチが入った後の情報を使うようにすれば、正確な描画が可能になります。 WM_LBUTTONUPの時も同様な処理が必要になります。

   • WT_PACKET

     アプリケーションがWintab初期化の時に、コンテキストにCXO_MESSAGEオプションをセットしていれば、Wintab Packetが生成されると同時にメッセージがアプリケーションに送られてきます［2.3］。このタイミングでWTPacket()関数を使ってデータを取り込みます。この時、どのくらいのパケットが来ており、後どのくらいのパケットを読み込まねばならないかを調べることで、データを漏らさず取り込むこともできます。WTQueuePackets()関数またはWTQueuePacketsEx()関数にてキューに残っているデータの最も古いシリアル番号と最新のシリアル番号を知ることができます。WTDataGet()関数でこのシリアル番号をパラメータにして、キューに残っている全てのパケットを読み出します。

   • WT_CSRCHANGE（またはWT_PROXIMITY）

     デバイスが入れ替わったり、有効領域にデバイスが入って来たり有効領域外に出たりした時にはWT_PROXIMITYメッセージが送られてきます。違うデバイスが有効領域に入って来た時にはWT_CSRCHANGEが送られてきます。この時点でWTInfo()関数を使ってデバイス固有のＩＤを読み取り、デバイスに対応した処理をプログラムすることが可能です。［5.1］

3. Wintabバージョンの識別
   同じWintabを使っていても、ライブラリが古くて新しいIntuosシリーズの機能が使えない場合もあります。Wintabバージョンを識別しておくことをお勧めします。［5.7］

4. コンテキストの切り替え
   アプリケーション毎にWintabコンテキストを設定することができます。Wintabを使うアプリケーションが同時に開いていた場合、Wintabはそれらのコンテキストがどのようにオーバーラップしているかを見て、最上位にあるコンテキストに従ってパケットを生成して送信します。
   アプリケーションは自分のコンテキストを最上位に持ってくるか下位にするかをWTOverlap()関数で設定することができます。例えば、アプリケーションがWM_ACTIVATEメッセージを受けた時、アクティブになった時は自分のコンテキストを最上位に、アクティブでなくなった時は最下位に設定することで、他のアプリケーションとの混乱を防ぐことができます。［3.3］

#include <WINDOWS.H>
.......
#include <MSGPACK.H>
#include <WINTAB.H>
#define PACKETDATA PK_X | PK_Y | PK_BUTTONS
#define PACKETMODE PK_BUTTONS
#include <PKTDEF.H>
.......

注) PACKETDATA／PACKETMODEのdefineは、必ず行ってください。

IF (!WTInfo(0, 0, NULL)) {
  エラー処理：WINTABが使用できない
}

データの流れを簡単な図で表わすと以下のようになります。

1. システムカーソルを使用するかどうかの設定

   システムを経由しないで（システムカーソルを表示しない）タブレットから情報を得る場合（これをデジタイジングコンキストと呼びます）と、システムカーソルを動かしながらタブレットの入力も行うモード（システムコンテキストと呼びます）の２種類があります。
   設定方法は、WTInfo 関数でデジタイジングコンテキストか システムコンテキストのどちらを選ぶかを指示します。

   Wintabの初期化を以下に示します。パラメータのカテゴリーにそれぞれ WTI_DEFCONTEXT または WTI_DEFSYSCTX を渡しています。これで得られた LOGCONTEXT のデータテーブルに必要な情報をセットしてWintabを初期化（ WTOpen 関数で行います）すると、アプリケーションに固有なWintab設定でタブレットを操作できるようになります。

   ◎ Wintabイベントのメッセージを利用して制御する場合

   WTInfo(WTI_DEFCONTEXT, 0, &lcMine);
   lcMine.lcOption |= CXO_MESSAGES; /* Wintabﾒｯｾｰｼﾞが渡されるようにする */
   lcMine.lcMsgBase = WT_DEFBASE;
   lcMine.lcPktData = PACKETDATA;
   lcMine.lcPktMode = PACKETMODE;
   lcMine.lcMoveMask = PACKETDATA;
   lcMine.lcBtnUpMask = lcMine.lcBtnDnMask;
   hTab = WTOpen(hWnd, &lcMine, TRUE); /* 初期化 */
   

   ◎ポーリング形の制御をする場合

   WTInfo(WTI_DEFSYSCTX, 0, &lcMine);
   lcMine.lcMsgBase = WT_DEFBASE;
   lcMine.lcPktData = PACKETDATA;
   lcMine.lcPktMode = PACKETMODE;
   lcMine.lcMoveMask = PACKETDATA;
   lcMine.lcBtnUpMask = lcMine.lcBtnDnMask;
   hTab = WTOpen(hWnd, &lcMine, TRUE);
   

2. スケーリングの初期化について
   以下のように、LOGCONTEXT の値を初期化する事でスケールの設定を行います。

   ① lcInOrgX,lcInOrgY にタブレットの入力開始座標
   ② lcInExtX,lcInExtY にタブレットの入力最大座標
   ③ lcOutExtX,lcOutExtY にウィンドウの解像度を設定します。
   ④ lcOutOrgX,lcOutOrgY に③で指示した解像度でカウントした場合の原点を指定します。通常０を入れます。

   デフォルトはタブレットドライバが設定している領域が割り当てられています。しかし、タブレット側でどのように有効領域内で操作範囲を設定しているかわからないので、タブレットの最大座標を求めて最大座標に設定することもあります。
   タブレットの最大座標を求めるには次の関数を使います。

   LONG minX,maxX,resX;
   LONG minY,maxY,resY;
   FIX32 axRes;
   WTInfo(WTI_DEVICES, DVC_X, &axis);
   maxX = axis.axMax; /* Ｘ方向の最大座標 */
   axResX = axis.axResolution; /* Ｘ座標の分解能 単位:line/inch */
   WTInfo(WTI_DEVICES, DVC_Y, &axis);
   maxY = axis.axMax; /* Ｙ方向の最大座標 */
   axResY = axis.axResolution; /* Ｙ座標の分解能 単位:line/inch */
   resX = HIWORD(axResX); /* highﾜｰﾄﾞが分解能の整数部になっています */
   resY = HIWORD(axResY); /* 以上はﾀﾌﾞﾚｯﾄ情報として持っておくと良いです*/
   WTInfo(WTI_DEFSYSCTX, 0, &lcMine);
   ....... 
   lcMine.lcInOrgX = lcMine.lcInOrgY = 0;
   lcMine.lcInExtX = maxX; /* ﾀﾌﾞﾚｯﾄの有効範囲全域を操作ｴﾘｱとします */
   lcMine.lcInExtY = maxY;
   lcMine.lcOutOrgX = lcMine.lcOutOrgY = 0;
   lcMine.lcOutExtX = maxX; /* ﾀﾌﾞﾚｯﾄの分解能と入力ﾃﾞｰﾀの分解能を */
   lcMine.lcOutExtY = maxY; /* あわせます */
   hTab = WTOpen(hWnd, &lcMine, TRUE); /* Wintabの初期化 */
   .......
   

   これでタブレットからでてくる生データを取り込むことができるようになります。
   ここで設定した内容はこのアプリケーション独自の設定としてWintabが管理します。

   lcMine.lcOutExtX = lcMine.lcInExtX;
   lcMine.lcOutExtY = lcMine.lcInExtY;
   

   とすれば、タブレットドライバのほうでスケーリングを設定していても、その設定を変えることなくかつタブレット分解能そのものを取り込むことができます。
   上記の①②③④の設定はデフォルト設定（とくに設定を書き込まない）にしておけば、現在のシステムのデフォルト設定でスケーリングが設定されます。
   ワコムのタブレットドライバのほうで設定したスケーリングはそのままデフォルト設定となっています。

   ⑤ lcSysOrgX,lcSysOrgY 及び lcSysExtX,lcSysExtY には表示画面の解像度（ピクセル値）に対してどの範囲でシステムカーソルを動作させるかをピクセル値で設定します。
   例えば、1024*768 の表示分解能であった時に、上記の値をそれぞれ 100,100、1000,700 とすると、タブレットの操作範囲いっぱいに動かしても画面上では設定したピクセルの範囲でしかシステムカーソルは動作しません。

3. 表示カーソルとの関係

   デジタイジングコンテキストの場合、表示カーソルは動作しません。
   マウスイベントは起こらないので、WT_PACKET のイベントメッセージを待って WTPacket()関数でタブレットデータを取得します。
   システムコンテキストの場合はシステムカーソルがタブレットのデバイスの操作にあわせて移動します。
   注意しなければならないのは、マウスのＸＹ情報はウィンドウの左上が原点となりますが、Wintabの場合は左下が原点となっていることです。
   得られる座標は③④のスケーリングの設定で示した内容になります。例えば③で 10000,10000、④で0,0を設定していると、タブレットの操作範囲の左下が0,0で右上隅が10000,10000という値になって座標値が返ってきます。

PACKET tPckt;
case WT_PACKET:
IF (WTPacket((HCTX)LOWORD(lParam), wParam, (LPSTR)&tPckt)) {
   Xcoodinate = tPckt.pkX; /* デジタイザ上のＸ座標 */
   Ycoodinate = tPckt.pkY; /* デジタイザ上のＹ座標 */
   Buttons = LOWORD(tPckt.pkButtons)); /* ボタン番号 */
}

PACKET tPckt;
case WT_PACKET:
IF (WTPacket((HCTX)LOWORD(lParam), wParam, (LPSTR)&tPckt)) {
   Xcoodinate = tPckt.pkX; /* デジタイザ上のＸ座標 */
   Ycoodinate = tPckt.pkY; /* デジタイザ上のＹ座標 */
   Buttons = LOWORD(tPckt.pkButtons)); /* ボタン番号 */
}

のように宣言していると、ボタン情報としては、ボタン番号が変化した時以外は０が返ってきます。プログラムの作り方によってはボタンダウン、ボタンアップのデータを取りこぼす場合があります。その時はボタンの状態が見えなくなってしまいますので注意が必要です。［4.4］
これはパケットデータキューのサイズが足りない場合に発生しますので、キューサイズを大きくすることで回避できる場合があります。

case WM_ACTIVATE:
IF (wParam) {
  WTOverlap(hTab, TRUE);
}
WTEnable(hTab, wParam);

このコーディングを行うと、自アプリケーションがアクティブの場合は、Wintabを経由して、タブレットの全域or一部を使用し、非アクティブの場合は、マウスエミュレーションで、他のアプリケーションが動作するようにすることができます。
また、Wintabを利用する複数のアプリケーションが動作している場合のコンフリクトを避けることができます。

ワコムのドライバが提供している情報は、UDⅡシリーズにおいては2,6,7,8,9,11,13です。Intuosシリーズについては、2,6,7,8,9,10,11,12,13がサポートされます。

（例）WTPacketが送られてきた順にPK_BUTTONSのデータを並べてみたものです。

#define PACKETMODE 0 と宣言してある場合は、常にボタンの状態を反映しており、先に述べたようにボタンの変化時だけデータが送られて来るのではなく、ボタンを押している間は押されたボタン番号がパケットのPK_BUTTONSに反映されます。

UINT orAzimuth;
UINT orAltitude;
UINT orTwist;

orAzimuthには傾きの方位が入ります。
X-Y平面に対して時計回りに360度までの方位であらわされます。
orAltitudeにはX-Y平面に対しての角度情報が入ります。
タブレット板面に対し垂直方向は90度、傾くに従い0度まで変化します。
消しゴムの情報はここでもわかります。ここには符号が付いているのですが、プラス符号なら通常のペン先、マイナス符号なら消しゴム側を示すようになっています。-90度は消しゴム側をタブレット面に垂直に立てた状態を表わし、ペンを傾けるに従い0度に近づきます。

// ここでWTPacketから得られたCursorタイプの値に対応してデバイスＩＤを読み取る事が
// できます。 PK_CURSORで識別されたデバイス＃に対応させて以下のように読み取ります。
LONG DevID0, DevID1, DevID3, DevKind0;
WTInfo (WTI_CURSORS, CSR_PHYSID, &DevID0); // ﾃﾞﾊﾞｲｽ#0のｼﾘｱﾙ番号を読み取る
WTInfo (WTI_CURSORS+1, CSR_PHYSID, &DevID1); // ﾃﾞﾊﾞｲｽ#1のｼﾘｱﾙ番号を読み取る
...
WTInfo (WTI_CURSORS+3, CSR_PHYSID, &DevID3); // ﾃﾞﾊﾞｲｽ#3のｼﾘｱﾙ番号を読み取る
// ﾃﾞﾊﾞｲｽの種別(12ﾋﾞｯﾄ)を読み取ります。12ﾋﾞｯﾄのうち、上位4ﾋﾞｯﾄ（bit8～11）と下位側
// の2ﾋﾞｯﾄ（bit1～2）でほとんどのﾃﾞﾊﾞｲｽを識別できます。上記同様ﾃﾞﾊﾞｲｽ#毎に読み取り
// 可能です。（以下の例ではPK_CURSORに対応するﾃﾞﾊﾞｲｽ種別を読み取っています）
WTPacketsGet((HCTX)hTab, 1, &pkt); // WTOpenで得られたﾊﾝﾄﾞﾙをhTabとしています
cursor = pkt.pkCursor;
WTInfo (WTI_CURSOR + cursor, CSR_TYPE, &DevKind0);
// ((DevKind0 & 0x0F06) == 0x0802) : General Pen
// ((DevKind0 & 0x0F06) == 0x0902) : Airbrush Pen
// ((DevKind0 & 0x0F06) == 0x0004) : 4D-Mouse
// ((DevKind0 & 0x0F06) == 0x0006) : 5 button puck

(1) PK_CURSOR で２または５という種別だった時。
(2) PK_ORIENTATION の orAltitude （傾き情報）がマイナスの角度だった時。
(3) PK_STATUS の TPS_INVERT ビットフィールドを見て、このビットがONした時。（V1.1より対応）

傾き情報は、板面に垂直の状態を90度で表わし、傾くに従って0度に近くなって表現されます（実際には30度くらいまで）。先ほどのAltitudeMaxが900だったなら、ペン先ではこの場合 +900～+300で推移する事になります。テールスイッチの時はAltitudeMinを見ます。これが-900ならばテールスイッチを90度から30度まで傾けた時、orAltitudeは -900～-300 という値で推移します。

LONG AzimuthMax, AltitudeMax, TwistMax, PrsMax, WhlMax;
LONG AzimuthMin, AltitudeMin, TwistMin, PrsMin, WhlMin;
AXIS PressAxis, OriAxis[3];
// WTI_DEVICESのDVC_NPRESSUREを取得 （筆圧値の最大、最小）
WTInfo(WTI_DEVICES, DVC_NPRESSURE, &PressAxis);
PrsMax = PressAxis.axMax;
PrsMin = PressAxis.axMin;
// WTI_DEVICESのDVC_TPRESSUREを取得 （ｴｱﾌﾞﾗｼﾎｲｰﾙﾃﾞｰﾀの最大、最小）
WTInfo(WTI_DEVICES, DVC_TPRESSURE, &PressAxis);
WhlMax = PressAxis.axMax;
WhlMin = PressAxis.axMin;
// WTI_DEVICESのDVC_ORIENTATIONを取得
// DVC_ORIENTATIONは、3つの要素（Azimuth,Atitude,Twist）のﾃﾞｰﾀが配列として渡されます
WTInfo(WTI_DEVICES, DVC_ORIENTATION, OriAxis);
// Azimuthのﾃﾞｰﾀ （ﾍﾟﾝの傾いた方向-XY平面に投影した角度の最大、最小）
AzimuthMax = OriAxis[0].axMax;
AzimuthMin = OriAxis[0].axMin;
// Altitudeのﾃﾞｰﾀ （XY平面に垂直な角度を最大値とする）
AltitudeMax = OriAxis[1].axMax;
AltitudeMin = OriAxis[1].axMin;
// Twistのﾃﾞｰﾀ （XY平面に垂直な軸を中心とした回転角度の最大、最小）
TwistMax = OriAxis[2].axMax;
TwistMin = OriAxis[2].axMin;
これでﾃﾞｰﾀを読み込んでみると、 例えばIntuos1･2･3ｼﾘｰｽﾞﾀﾌﾞﾚｯﾄを使用していた場合には、
PrsMax = 1023 /* 筆圧の最大値 */
PrsMin = 0 /* 筆圧の最小値 */
WhlMax = 1023 /* ｴｱﾌﾞﾗｼﾎｲｰﾙの最大値 */
WhlMin = 0 /* ｴｱﾌﾞﾗｼﾎｲｰﾙの最小値 */
AzimuthMax = 3600 /* 方位の最大値 */
AzimuthMin = 0 /* 方位の最小値 */
AltitudeMax = 900 /* 角度の最大値 */
AltitudeMin = -900 /* 角度の最小値 ｲﾚｰｻを使った時負の数値で傾きを表わします */
TwistMax = 3600 /* 回転角の最大値 */
TwstMin = 0 /* 回転角の最小値 */

となります。
傾き角度の最大、最小の値は、符号無しの時は0からAltitudeMaxまで、符号付きの場合は0からAltitudeMinの絶対値が、それぞれ板面に対して傾き角度0度から90度に対応していると考えてください。

LONG TabMax_X, TabMin_X, TabRes_X;
UINT TabUni_X;
AXIS axis;
WTInfo(WTI_DEVICES, DVC_X, &axis);
TabMax_X = axis.axMax;
TabMin_X = axis.axMin;
TabUni_X = axis.axUnits;
TabRes_X = HIWORD(axis.axResolution);

ここで、TabMax_XにはX座標の最大値、TabMin_XにはX座標の最小値が入ります。
TabUni_Xには分解能の単位、TabRes_Xには分解能が入ります。
分解能の単位には４つあり、line/inch、line/cm、Circle（deg/radian）、none（単位無し）があります。それぞれWintab.hで定義されている、TU_INCHES、TU_CENTIMETERS、TU_CIRCLE、TU_NONE、で識別します。
例えば、TabMax_Xが38480、TabMin_xが0、TabUni_XがTU_CENTIMETERS、TabRes_Xが1000となっていた場合、分解能は0.01mm（1000line/cm）、有効領域の実寸がX軸方向に384.8mmある、と知ることができます。

int i;
char Name[80];
UINT size;
BOOL gSupportsEraser;
gSupportsEraser=FALSE;
for (i = 0; size = WTInfo(WTI_CURSORS + i, CSR_NAME, Name); i++) {
         if(!strcmp("Eraser Stylus",Name)){
                  gSupportsEraser=TRUE;
         }
}

上記のNameのエリアには利用可能な座標指示器の種別として次のような文字列が入ります。
“Standard Stylus” (ノーマルペン) 15文字
“Pressure Stylus“ (筆圧ペン) 15文字
“Eraser Stylus” (テールスイッチ付き筆圧ペン) 15文字
“Puck” (カーソル) 4文字
WTI_CURSORS に+1しながら読んでゆくと、Nameのエリアには上記の文字列が、sizeには文字列+1スペースの文字数が入ります。対応した座標指示器をすべて読み出したらsizeが0で返ってきます。
パケットデータにはデバイス番号が含まれています。pkCursorとして渡される番号で上記のように読めば、現在使用中のデバイスの文字列を取得できます。

WTPacketsGet((HCTX)hTab, 1, &pkt);     // WTOpenで得られたﾊﾝﾄﾞﾙをhTabとしています
cursor = pkt.pkCursor;
WTInfo(WTI_CURSORS + cursor, CSR_NAME, Name)
．．．

HMGR hMgr = NULL;
BOOL *ObtBuf;
case WM_CREATE:
         // ﾀﾌﾞﾚｯﾄﾏﾈｰｼﾞｬｰの作成
         hMgr = WTMgrOpen(hWnd, WT_DEFBASE);
         if(hMgr) {
             // Out of Bounds Tracking のｾｯﾄ
             ObtBuf[0] = 1;
             WTMgrExt(hMgr, WTX_OBT, ObtBuf);
//           WTMgrClose(hMgr); /* ここでクローズしても良い */
         }
case WM_DESTROY:
         // ﾀﾌﾞﾚｯﾄﾏﾈｰｼﾞｬｰをｸﾛｰｽﾞする
//       hMgr = WTMgrOpen(hWnd, WT_DEFBASE); /* 一度クローズしていたら再度オープン */
         if (hMgr) {
           // Out of Bounds Tracking の解除
           ObtBuf[0] = 0;
           WTMgrExt(hMgr, WTX_OBT, ObtBuf);
           WTMgrClose(hMgr);
         }

HCTX hTab = NULL;
case WM_CREATE:
    hTab = TabletInit(hWnd);
    // ﾊﾟｹｯﾄﾃﾞｰﾀｷｭｰｻｲｽﾞの変更
   WTQueueSizeSet((HCTX)hTab, 16);
....                          ↑
....                        ｷｭｰのｻｲｽﾞ

オーバーフローしているかどうかはWTQueuePackets()関数を使って知ることができます。パケットには連続した番号がつけられます。（注意：あくまでもアプリケーションに渡される時の連番ですので、オーバーフローして取得できなかったパケットがあるかどうかはわかりません） この番号を見て、常にキューにパケットがいっぱい溜まっている状況であれば、オーバーフローを起こしてデータを失っている可能性があるといえます。これによってアプリケーションの負荷を推測する事もできます。

DWORD Queue;
int QueueSize;
case WT_PACKET:
       if (WTPacket((HCTX)lParam, wParam, &pkt)) {
              ....
              // ﾊﾟｹｯﾄﾃﾞｰﾀｷｭｰについての操作
              Queue = WTQueuePackets((HCTX)lParam);
              QueueSize = WTQueueSizeGet((HCTX)lParam);
              ....
       }
HIWORD(Queue) : 最も新しいﾊﾟｹｯﾄのｼﾘｱﾙﾅﾝﾊﾞｰ （-1であればｷｭｰﾊﾞｯﾌｧは空です）
LOWORD(Queue) : 最も古いﾊﾟｹｯﾄのｼﾘｱﾙﾅﾝﾊﾞｰ （0であればｷｭｰﾊﾞｯﾌｧは空です）
QueueSize : ﾊﾟｹｯﾄﾃﾞｰﾀｷｭｰに保持できるﾊﾟｹｯﾄの数

int thisVersion;
WTInfo ( WTI_INTERFACE, IFC_SPECVERSION, &thisVersion);

上位バイトにはメジャーバージョン、下位バイトはマイナーバージョンが返されます。V1.0であればメジャーバージョンは１、マイナーバージョンは０です。

参考資料：
各デバイスのデバイスＩＤを示す。

すべてのタブレット関数名には、「WT」というプレフィックスおよびWINAPIと同じ属性があります。アプリケーションは、前のセクションで定義したとおり、標準ファイルおよびモジュール名を持つダイナミックリンクライブラリを介して、タブレットインターフェース機能へのアクセス権を取得します。アプリケーションは、Windows関数LoadLibrary、FreeLibrary、およびGetProcAddressを使用して機能にリンクすることも、インポートライブラリを使用することもできます。

32ビットWintab固有の情報：関数WTInfo、WTOpen、WTGet、およびWTSetには、ANSIバージョンとUnicodeバージョンがあります。いずれも、Win32 APIで使用されている同じANSI/Unicode移植規約を使用しています。移植できない関数WTQueuePackets、WTMgrCsrPressureBtnMarksは、移植可能な新しい関数WTQueuePacketsEx、WTMgrCsrPressureBtnMarksExに置き換えられています。

表5.1. ダイナミックリンクの関数の序数

ダイナミックリンクの序数を下記の表で定義します。2つの序数エントリが表示されている場合、最初のエントリは、16ビットおよび32ビットANSIバージョンの関数を示します。2番めのエントリは32ビットUnicodeバージョンを示します。

6.1.1. WTInfo

6.1.2. WTOpen

6.1.3. WTClose

6.1.4. WTPacketsGet

6.1.5. WTPacket

6.2.1. WTEnable

6.2.2. WTOverlap

6.3.1. WTEnable

6.3.2. WTSet（1.1変更）

6.3.3. WTExtGet

6.3.4. WTExtSet

6.3.5. WTSave

6.3.6. WTRestore

6.4.1. WTEnable

6.4.2. WTDataGet

6.4.3. WTDataPeek

6.4.4. WTQueuePackets（16ビットのみ）

6.4.5. WTQueuePacketsEx

6.4.6. WTQueueSizeGet

6.4.7. WTQueuePacketsEx

6.5.1. WTMgrOpen

6.5.2. WTMgrClose

6.6.1. WTMgrContextEnum

6.6.2. WTMgrContextOwner

6.6.3. WTMgrDefContext

6.6.4. WTMgrDefContextEx（1.1変更、1.4変更）

6.7.1. WTMgrCsrButtonMap

6.7.2. WTMgrCsrPressureBtnMarks（16ビットのみ）

6.7.3. WTMgrCsrPressureBtnMarksEx

6.7.4. WTMgrCsrPressureResponse

下記のメッセージ名は、実際には、アプリケーション選択ベースからの固定オフセットを表します。インターフェース定義は、将来のメッセージ定義に備えて16のオフセットを保持しています。デフォルトメッセージベースは、16進数7FF0で定義したグローバル定数値WT_DEFBASEです。このデフォルト値は、多くのアプリケーションで妥当で安全なものですが、メッセージ名の競合を防ぐのは、アプリケーションプログラマの責任です。

32ビットWintab固有の情報：ほとんどのメッセージ引数の種類は32ビットWintabではより幅広くなっていますが、wParamからlParam（またはその反対）にジャンプしたメッセージ引数はありません。最も広い引数は現在、これまで未使用または使用不可だったスペースを占めています。WT_INFOCHANGEのカテゴリーおよびインデックス引数は広げられていないので注意してください。いずれも、まだ16ビットです。Wintab Programmer’s KitのヘッダーファイルWINTABX.Hには、16ビットでも32ビットでも使用できる、移植可能な「メッセージクラッカー」マクロが含まれています。

7.1.1. WT_PACKET

7.1.2. WT_PACKET

7.2.1. WT_CTXOPEN

7.2.2. WT_PACKET

7.2.3. WT_CTXUPDATE

7.2.4. WT_CTXOVERLAP

7.2.5. WT_PROXIMITY

7.3.1. WT_INFOCHANGE（1.4変更）

表8.1. 一般的なデータ型

8.2.1. AXIS

typedef struct tagAXIS {
        LONG    axMin;
        LONG    axMax;
        UINT axUnits;
        FIX32     axResolution;
} AXIS;

8.2.2.　情報カテゴリーおよびインデックス（1.1変更）

8.3. コンテキストデータ構造体

#define LC_NAMELEN 40
typedef struct tagLOGCONTEXT {
TCHAR  lcName[LC_NAMELEN];
        UINT   lcOptions;
       UINT   lcStatus;
       UINT   lcLocks;
       UINT   lcMsgBase;
       UINT   lcDevice;
       UINT   lcPktRate;
       WTPKT  lcPktData;
       WTPKT  lcPktMode;
       WTPKT  lcMoveMask;
       DWORD  lcBtnDnMask;
       DWORD  lcBtnUpMask;
       LONG   lcInOrgX;
       LONG   lcInOrgY;
       LONG   lcInOrgZ;
       LONG   lcInExtX;
       LONG   lcInExtY;
       LONG   lcInExtZ;
       LONG   lcOutOrgX;
       LONG   lcOutOrgY;
       LONG   lcOutOrgZ;
       LONG   lcOutExtX;
       LONG   lcOutExtY;
       LONG   lcOutExtZ;
       FIX32  lcSensX;
       FIX32  lcSensY;
       FIX32  lcSensZ;
       BOOL   lcSysMode;
       int    lcSysOrgX;
       int    lcSysOrgY;
       int    lcSysExtX;
       int    lcSysExtY;
       FIX32  lcSysSensX;
       FIX32  lcSysSensY;
} LOGCONTEXT;

Let:
 
In = 軸の入力値
Out = 軸の出力値
InOrg = 軸の入力原点（lcInOrgXなど）
InExt = 軸の入力範囲（lcInExtXなど）
OutOrg = 軸の出力原点（lcOutOrgXまたはlcSysOrgX など）
OutExt = 軸の出力範囲（lcOutExtXまたはlcSysExtX など）
入力値が0以上の場合、sign() は1を返し、
  それ以外の場合は-1を返します。
abs()は入力の絶対値を返します。
 
if sign(OutExt) == sign(InExt)
  Out = ((In - InOrg) * abs(OutExt) / abs(InExt)) + OutOrg
else
  Out = ((abs(InExt) - (In - InOrg)) * abs(OutExt) /
    abs(InExt)) + OutOrg
 
移動マスクおよびボタンマスクは、コンテキストによって処理されるイベントの種類を決定します。

このセクションでは、イベントを返すために使用されるデータ構造体について説明します。定義には、パケット用の変数データ構造体、関連する構造体、および定数のファミリーが含まれます。

8.4.1. PACKET（1.1変更）

typedef struct tagPACKET {
        HCTX   pkContext;
        UINT   pkStatus;
        LONG   pkTime;
        WTPKT  pkChanged;
        UINT   pkSerialNumber;
        UINT   pkCursor;
        DWORD  pkButtons;
        DWORD  pkX;
        DWORD  pkY;
        DWORD  pkZ;
        UINT   pkNormalPressure;
        UINT   pkTangentPressure;
        ORIENTATION pkOrientation;
        ROTATION    pkRotation;  /* 1.1 */
} PACKET;

8.4.2. ORIENTATION

typedef struct tagORIENTATION {
        int   orAzimuth;
        iint   orAltitude;
        iint   orTwist;
} ORIENTATION;

8.4.3. ROTATION (1.1)

typedef struct tagROTATION {
        iint   roPitch;
        iint   roRoll;
        iint   roYaw;
} ROTATION;

付録A. PKTDEF.Hの使用

#include <wintab.h>
#define PACKETDATA   PK_X | PK_Y | PK_BUTTONS   /* x、y、ボタン */
#define PACKETMODE   PK_BUTTONS       /* ボタンの相対モード */
#include <pktdef.h>
...
  lc.lcPktData = PACKETDATA;
  lc.lcPktMode = PACKETMODE;

#include <wintab.h>
#define PACKETNAME    MOE
#define MOEPACKETDATA   PK_X | PK_Y | PK_BUTTONS   /* x、y、ボタン */
#define MOEPACKETMODE   PK_BUTTONS       /* ボタンの相対モード */
#include <pktdef.h>
#define PACKETNAME    LARRY
#define LARRYPACKETDATA    PK_Y | PK_Z | PK_BUTTONS   /* y、z、ボタン */
#define LARRYPACKETMODE    PK_BUTTONS       /* ボタンの相対モード */
#include <pktdef.h>
#define PACKETNAME    CURLY
#define CURLYPACKETDATA    PK_X | PK_Z | PK_BUTTONS   /* x、z、ボタン */
#define CURLYPACKETMODE    PK_BUTTONS       /* ボタンの相対モード */
#include <pktdef.h>
...
  lcMOE.lcPktData = MOEPACKETDATA;
  lcMOE.lcPktMode = MOEPACKETMODE;
...
  lcLARRY.lcPktData = LARRYPACKETDATA;
  lcLARRY.lcPktMode = LARRYPACKETMODE;
...
  lcCURLY.lcPktData = CURLYPACKETDATA;
  lcCURLY.lcPktMode = CURLYPACKETMODE;

付録B. 拡張定義（1.4変更）

B.1. 拡張プログラミング

UINT ScanExts(UINT wTag)
{
  UINT i;
  UINT wScanTag;
 
  /* wTagの情報カテゴリーをスキャン。*/
  for (i = 0; WTInfo(WTI_EXTENSIONS + i, EXT_TAG, &wScanTag); i++) {
     if (wTag == wScanTag) {
      /* WTI_EXTENSIONSからカテゴリーオフセットを返す。*/
      return i;
    }
  }
  /* エラーコードを返す。*/
  return 0xFFFF;
}

B.2. Out of Bounds Tracking（境界外トラッキング）

B.5. カーソルマスク

B.6. Extended Button Masks（拡張ボタンマスク）

typedef struct tagXBTNMASK {
  BYTE xBtnDnMask[32];
  BYTE xBtnUpMask[32];
} XBTNMASK;

B.7. Express Keys（ファンクションキー）拡張（1.4変更）

B.8. Touch Strips（トラックパッド）およびTouch Rings（タッチホイール）拡張（1.4変更）

B.9. 拡張の構造（1.4変更）

typedef struct tagEXPKEYSDATA { /* 1.4 */
    BYTE    nTablet;    // タブレットのインデックス
    BYTE    nControl;   // コントロールの位置インデックス
    BYTE    nLocation;  // コントロールの位置
    BYTE    nReserved;  //
    DWORD   nState;     // コントロールの状態（1 - 押下、0 - リリース）
} EXPKEYSDATA;

typedef struct tagSLIDERDATA { /* 1.4 */
    BYTE    nTablet;    // タブレットのインデックス
    BYTE    nControl;   // コントロールの位置インデックス
    BYTE    nFunction;  // 制御関数インデックス
    BYTE    nReserved;  //
    DWORD   nPosition;  // コントロール上の指の位置（タッチがない場合はゼロ）
} SLIDERDATA;

typedef struct tagEXTPROPERTY { /* 1.4 */
    BYTE    version;   // 構造体バージョン、現在は0
    BYTE    tabletIndex;    // 0から始まるタブレットのインデックス
    BYTE    controlIndex;   // 0から始まるコントロールのインデックス 
    BYTE    functionIndex;  // 0から始まるコントロールのサブ関数のインデックス
    WORD    propertyID;     // プロパティID
    WORD    reserved;  // DWORDアラインメントフィルタ
    DWORD   dataSize;  // data[]バッファのバイト数
    BYTE    data[1];   // 未処理データ
} EXTPROPERTY;

付録C. 追加機能（1.4変更））

// 傾きに関する情報を取得
struct tagAXIS tiltOrient[3];
BOOL tiltSupport = FALSE;
tiltSupport = WTInfo(WTI_DEVICES, DVC_ORIENTATION, &tiltOrient);
if (tiltSupport )
{
    // タブレットは方位角と傾き角をサポートしているか 
    if (tiltOrient[0].axResolution && tiltOrient[1].axResolution)
    {
   // 分解能を取得
   azimuth = tiltOrient[0].axResolution;
   altitude = tiltOrient[1].axResolution;
    }
    else
    {
   tiltSupport = FALSE;
    }
} 

// 回転に関する情報を取得
struct tagAXIS tiltOrient[3];
BOOL rotateSupport = FALSE;
rotateSupport = WTInfo(WTI_DEVICES, DVC_ORIENTATION, &tiltOrient);
if (rotateSupport)
{
    // タブレットは湾曲をサポートしているか
    if (!tiltOrient[2].axResolution)
    {
   rotateSupport = FALSE;
    }
} 
同じデータ構造体にあるので、おそらく傾斜の確認と同時にこれを確認することになるでしょう。

// サムホイールに関する情報を取得
struct tagAXIS thumbwheelAxis;
BOOL thumbwheelSupport = FALSE;
thumbwheelSupport = WTInfo(WTI_DEVICES, DVC_Z, &thumbwheelAxis);
if (thumbWheelSupport)
{
    // タブレットはサムホイールをサポートしているか
    if (!thumbwheelAxis.axResolution)
    {
   thumbwheelSupport = FALSE;
    }
}