ProcessPointerFramesInteractionContext2 與 BufferPointerPacketsInteractionContext2 函式

[部分資訊涉及預售產品,可能在商業發行前經過大幅修改。 Microsoft 對此處提供的資訊不作明示或暗示的任何保證。]

處理指標框架或緩衝區,並對具有擴展指標類型資訊的指標封包進行互動上下文處理。

語法

HRESULT
WINAPI
ProcessPointerFramesInteractionContext2(
    _In_ HINTERACTIONCONTEXT interactionContext,
    _In_ UINT32 entriesCount,
    _In_ UINT32 pointerCount,
    _In_reads_(entriesCount * pointerCount) const POINTER_TYPE_INFO *pointerInfo);

HRESULT
WINAPI
BufferPointerPacketsInteractionContext2(
    _In_ HINTERACTIONCONTEXT interactionContext,
    _In_ UINT32 entriesCount,
    _In_reads_(entriesCount) const POINTER_TYPE_INFO *pointerInfo);

參數

互動背景

互動上下文的一個稱號。

條目計數

指標 Info 陣列中的條目(幀數)。 對於 ProcessPointerFramesInteractionContext2,元素總數為 entriesCount × 指標計數。 對於 BufferPointerPacketsInteractionContext2,這是元素的總數。

指標計數

(僅限 ProcessPointerFramesInteractionContext2 。)每幀指標數量。

指標資訊

指向包含指標輸入資料的 POINTER_TYPE_INFO 結構陣列的指標。

返回值

如果函式成功,則會傳回 S_OK

若函式失敗,則回傳 HRESULT 錯誤碼。

備註

這些 API 的運作方式與其對應的 ProcessPointerFramesInteractionContextBufferPointerPacketsInteractionContext 完全相同。 它們唯一的差別是採用 POINTER_TYPE_INFO 緩衝區而非 POINTER_INFO 緩衝區。 這些 API 使互動上下文能在適當時使用擴展指標資訊有效載荷。

觸控板輸入時,必須使用這些 API 取代它們的對應API。 POINTER_TYPE_INFO結構中擴展的資訊是正確的觸控板手勢辨識所必需的。

要求

需求 價值
最低支援的用戶端 Windows 11 [僅限桌面應用程式]
最低支援的伺服器 不支援
Header 互動上下文.h
圖書館 Ninput.lib
DLL Ninput.dll(序數為 ProcessPointerFramesInteractionContext2,序數為 2508,BufferPointerPacketsInteractionContext2 為序數 2508)

另請參閱