GetTouchInputInfo

函式說明

檢索有關特定觸控輸入句柄關聯的觸控輸入的詳細信息。

語法

BOOL WINAPI GetTouchInputInfo(

__in HTOUCHINPUT hTouchInput,

__in UINT cInputs,

__out PTOUCHINPUT pInputs,

__in int cbSize

);

參數

hTouchInput [in]

在觸控訊息的 LPARAM 中接收到的觸控輸入句柄。如果該句柄無效，則函式將失敗，並顯示 ERROR_INVALID_HANDLE。請注意，在對 CloseTouchInputHandle 的成功調用中使用該句柄之後，或者在將該句柄傳遞給 DefWindowProc, PostMessage, SendMessage 或它們的某個變數之後，該句柄將無效。

cInputs [in]

pInputs 數組中的結構數。理想情況下，這應至少等於訊息關聯的觸控點的數目，如訊息 WPARAM 中所示。如果 cInputs 小於觸控點的數目，則函式仍將成功，並且在 pInputs 緩衝區中填充有關 cInputs 觸控點的信息。

pInputs [out]

指向一組 TOUCHINPUT 結構的指針，這些結構用於接收有關指定的觸控輸入句柄關聯的觸控點的信息。

cbSize [in]

單個 TOUCHINPUT 結構的大小（以位元組為單位）。如果 cbSize 不是單個 TOUCHINPUT 結構的大小，則函式將失敗，並顯示 ERROR_INVALID_PARAMETER。

返回值

如果函式成功，則返回值為非零值。如果函式失敗，則返回值為零。若要獲取擴展的錯誤信息，請使用 GetLastError 函式。

評論

調用 CloseTouchInputHandle 將不會釋放在對 GetTouchInputInfo 的調用中檢索的值關聯的記憶體。傳遞給 GetTouchInputInfo 的結構中的值將一直有效，直至您刪除它們。

要求

最低支持的客戶端	Windows 7
最低支持的伺服器	Windows Server 2008 R2
標頭	Winuser.h (包括Windows.h)
庫	User32.lib
DLL	User32.dll

另請參見

函式

CloseTouchInputHandle