Funkcje ProcessPointerFramesInteractionContext2 i BufferPointerPacketsInteractionContext2

[Niektóre informacje odnoszą się do wstępnie wydanego produktu, który może zostać znacząco zmodyfikowany przed jego wydaniem komercyjnym. Microsoft nie udziela żadnych gwarancji, wyraźnych ani domniemanych, w odniesieniu do informacji podanych tutaj.]

Przetwarza ramki wskaźnika lub bufory pakiety wskaźnika z rozszerzonymi informacjami o typie wskaźnika dla kontekstu interakcji.

Składnia

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);

Parametry

interactionContext

Dojście do kontekstu interakcji.

entriesCount

Liczba wpisów (ramek) w tablicy pointerInfo . W przypadku elementu ProcessPointerFramesInteractionContext2 całkowita liczba elementów to entriesCount × wskaźnikCount. W przypadku elementu BufferPointerPacketsInteractionContext2 jest to całkowita liczba elementów.

wskaźnikCount

(Tylko element ProcessPointerFramesInteractionContext2 ). Liczba wskaźników na ramkę.

pointerInfo

Wskaźnik do tablicy struktur POINTER_TYPE_INFO zawierających dane wejściowe wskaźnika.

Wartość zwracana

Jeśli funkcja powiedzie się, zwraca S_OK.

Jeśli funkcja nie powiedzie się, zwraca kod błędu HRESULT .

Uwagi

Te interfejsy API działają identycznie z ich odpowiednikami ProcessPointerFramesInteractionContext i BufferPointerPacketsInteractionContext. Ich jedyną różnicą jest przyjmowanie buforu POINTER_TYPE_INFO zamiast buforu POINTER_INFO . Te interfejsy API umożliwiają kontekstowi interakcji użycie ładunku informacji o rozszerzonym wskaźniku, jeśli jest to konieczne.

W przypadku danych wejściowych touchpad te interfejsy API muszą być używane zamiast ich odpowiedników. Rozszerzone informacje w strukturze POINTER_TYPE_INFO są wymagane do prawidłowego rozpoznawania gestów touchpad.

Wymagania

Wymaganie Wartość
Minimalny obsługiwany klient Windows 11 [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer Brak obsługiwanych
Nagłówek InteractionContext.h
Biblioteka Ninput.lib
DLL Ninput.dll (porządkowy 2507 dla elementu ProcessPointerFramesInteractionContext2, porządkowy 2508 dla bufferPointerPacketsInteractionContext2)

Zobacz także