GetPointerTouchInfo 函式 (winuser.h)

取得與目前訊息相關聯之指定指標 (類型 PT_TOUCH) 的觸控型資訊。

語法

BOOL GetPointerTouchInfo(
  [in]  UINT32             pointerId,
  [out] POINTER_TOUCH_INFO *touchInfo
);

[in] pointerId

要擷取資訊的指標識別碼。

[out] touchInfo

要接收觸控特定指標資訊的 POINTER_TOUCH_INFO 結構位址。

如果函式成功，則傳回值為非零。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

GetPointerTouchInfo 會擷取與指標訊息相關聯之類型 PT_TOUCH () 單一指標的資訊。

使用 GetPointerFrameTouchInfo 擷取與一組指標訊息相關聯的框架資訊。

GetPointerTouchInfo所傳回的資訊與呼叫執行緒所擷取的最新指標訊息相關聯。當呼叫執行緒擷取下一個訊息時，可能無法再使用與上一個訊息相關聯的資訊。

如果應用程式未盡可能快速地處理指標輸入訊息，某些訊息可能會聯合成 WM_POINTERUPDATE 訊息。使用 GetPointerTouchInfoHistory 從最新的 WM_POINTERUPDATE 訊息擷取訊息歷程記錄。

如果不再提供與訊息相關聯的資訊，此函式會失敗，並將最後一個錯誤設定為 ERROR_NO_DATA。

如果呼叫執行緒沒有擁有已傳遞指標訊息的視窗，此函式會失敗，並將最後一個錯誤設定為 ERROR_ACCESS_DENIED。請注意，這可能是輸入最初傳遞至的視窗，或者可能是訊息轉送至的視窗。

如果指定的指標類型不是 PT_TOUCH，則此函式會失敗，並將最後一個錯誤設定為 ERROR_DATATYPE_MISMATCH。