skipPointerFrameMessages 函式 (winuser.h)

判斷哪一個指標輸入框架產生指定指標最近擷取的訊息，並捨棄從相同指標輸入框架產生的任何佇列 (未偵測的) 指標輸入訊息。 如果應用程式已使用 GetPointerFrameInfo 函式擷取整個框架的資訊， GetPointerFrameInfoHistory 函式或其類型特定的變體之一，則可以使用此函式來避免擷取和捨棄該框架的其餘訊息。

語法

BOOL SkipPointerFrameMessages(
  [in] UINT32 pointerId
);

參數

[in] pointerId

指標的標識碼。 對於包含此指標最近擷取之輸入的框架，將會略過暫止訊息。

傳回值

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

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

備註

平行模式裝置可能會報告畫面格中的指標輸入，也就是說，它們可能會向系統報告來自該裝置的所有指標的狀態和位置。 在理想情況下，除非應用程式特定需求另有規定，否則應用程式應該將整個框架視為單一輸入。

SkipPointerFrameMessages 函式可以與 GetPointerFrameInfo 函式搭配使用， (或其類型特定的變體之一) ，以使用整個畫面做為單一輸入。

當應用程式看到指標訊息時，可以使用 GetPointerFrameInfo 函式來擷取指標訊息所屬的整個指標輸入框架，因此取得視窗目前擁有之所有指標的更新檢視。 請注意，傳回的框架只包含目前由與指定指標相同的視窗所擁有的指標。

擷取整個資訊框架之後，應用程式就可以呼叫 SkipPointerFrameMessages 函式，略過與擱置擷取此框架相關聯的其餘指標訊息。 這樣可節省應用程式擷取和處理其餘訊息的額外負荷。

警告只有當呼叫端可以確定呼叫端線程上沒有其他實體 (例如直接操作) 預期擷取暫止指標訊息時，才應該使用SkipPointerFrameMessages函式。 基於這個理由，當處理多個同時互動時， SkipPointerFrameMessages 不應該與直接操作搭配使用。

 

請注意，所擷取的信息與呼叫線程最近擷取的指標框架相關聯。 呼叫線程擷取其下一則訊息之後，與先前指標框架相關聯的資訊可能無法再使用。

如果指標框架除了指定的指標之外未包含其他指標，則此函式會成功且沒有動作。

如果呼叫線程沒有擁有已傳遞指標訊息的視窗，此函式會失敗，並將最後一個錯誤設定為 ERROR_ACCESS_DENIED。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll

請參閱

函式