構文
パラメーター
surfaceIndex _In_型: uint32_t タッチ サーフェスのインデックス。IGameInputDevice::GetTouchSurfaceCount から返される値より小さくなければなりません。 contactArrayCount _In_
型: uint32_t contactArray の要素数。 contactArray _Out_writes_to_opt_(contactArrayCount, return)
型: GameInputTouchContact* タッチ サーフェス上の接触点を受け取る配列。null を指定できます。
戻り値
型: uint32_t contactArray が null の場合は、タッチ サーフェス上の接触点の数を返します。それ以外の場合は、contactArray に書き込まれた接触点の数を返します。これは、接触点の数と contactArrayCount のうち小さい方の値です。読み取りにタッチ データが含まれていない場合、または surfaceIndex が有効なサーフェス インデックスではない場合は 0 を返します。解説
contactArray の各要素は、サーフェス上の指などの 1 つの接触点を記述します。接触点が書き込まれなかった contactArray の要素は 0 に設定されます。GameInputTouchContact のcontactId メンバーは、接触点がサーフェス上に残っている限り同じ値のままであるため、読み取り間で接触点を追跡するために使用できます。
contactArray のサイズを決定するには、IGameInputReading::GetTouchContactCount を呼び出すか、GameInputTouchSurfaceInfo の maxContactCount メンバーを使用して、どの読み取りにも十分な大きさの配列を割り当てます。接触点の座標を解釈するには、同じサーフェス インデックスを指定して IGameInputDevice::GetTouchSurfaceInfo を呼び出します。
タッチ データを含む読み取りでは、IGameInputReading::GetInputKind に GameInputKindTouch が含まれます。
タッチのサポートは、デバイスとプラットフォームによって異なります。
要件
ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体関連項目
GameInput の概要IGameInputReading
IGameInputReading::GetTouchContactCount
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact
GameInputTouchSurfaceInfo
