GetTouchInputInfo

putIn putIn putIn

函式說明

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

語法

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

相關詞條

相關搜尋

熱門詞條

聯絡我們