函式說明
檢索有關特定觸控輸入句柄關聯的觸控輸入的詳細信息。語法
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 |