GetMouseMovePoints

簡介

函式功能：該函式取得滑鼠或畫筆。

函式原型：int GetMouseMovePoints（UINT cbSize，LPMOUSEMOVEPOlNT lppt，LPMOUSEMOVEPOINT IpptBuf，int nBufPoints，DWORD resolution）；

參數：

cbSize：結構MOUSEMOVEPOINT的大小。

lppt：指向結構MOUSEMOVEPOINT的指針，該結構包含了有效的滑鼠坐標（螢幕坐標）。也可以包含一個時間標記。

函式GetMouseMovePoints在滑鼠坐標歷史記錄中查找一點。如果此函式查到該點，則返回包含提供點在內的在此之前的最後一個nBufPoints。如果應用程式提供一個時間標記，則函式GetMouseMovePoints將用它來區分記錄於不同時間的兩個相等的點。

應用程式使用從訊息WM_MOUSEMOVE中接收的滑鼠坐標來調用此函式，並把它們轉換為螢幕坐標。

lpptBuf：將接收點的緩衝區的指針。其大小至少應為cbsze· nBuffPoints。

nBufPoints：指定將取得的點的個數。

resolution：指定希望的解析度。此參數可取下列值之一：

GMMP_USE_DISPLAY_POINTS：用顯示解析度取得點。

GMMP_USE_DRIVER_pOINTS：用驅動器解析度取得點。在Windows CE平台下，畫筆驅動器的解析度高於顯示解析度。這樣，函式GetMouseMovePoints可被那些需要準確解析度的應用程式使用。（如手寫體識別軟體或計算機輔助設計軟體）。

返回值：如果函式調用成功，返回值是緩衝區裡的點的數目。否則，函式返回C1。若想獲得更多的錯誤信息，請調用GetlastError函式。函式GetLastError可能返回下面的錯誤代碼。

GMMF_ERR_POINT_NOT_FOUNQ由lPPt指定的點找不到或不再存在於系統緩衝區中。

備註：系統至少保留著64個滑鼠坐標及其時間標記。如果應用程式給GetMouseMovePoints提供了一個滑鼠坐標，而該坐標存在於系統中的滑鼠坐標歷史記錄中，則函式從歷史坐標記錄取得指定個數的坐標。也可以提供一個時間標記，用來區分歷史記錄中相同的點。

函式GetMouseMonePoints將返回實際傳送給調用執行緒和其他執行緒的點。

速查：Windows NT：5.0及以上版本；Windows：98及以上版本；Windows CE：2.0及以上版本；頭檔案：winuser.h；輸入庫：user32.lib。