ProcessPointerFramesInteractionContext2- und BufferPointerPacketsInteractionContext2-Funktionen

[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklichen oder konkludenten Angaben in Bezug auf die hier bereitgestellten Informationen.]

Verarbeitet Zeigerframes oder Puffer zeigerpakete mit erweiterten Zeigertypinformationen für einen Interaktionskontext.

Syntax

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

Parameter

interactionContext

Ein Handle für den Interaktionskontext.

entriesCount

Die Anzahl der Einträge (Frames) im PointerInfo-Array . Bei ProcessPointerFramesInteractionContext2 ist die Gesamtanzahl der Elemente "entriesCount " × pointerCount. Bei BufferPointerPacketsInteractionContext2 ist dies die Gesamtanzahl der Elemente.

pointerCount

(Nur ProcessPointerFramesInteractionContext2 .) Die Anzahl der Zeiger pro Frame.

pointerInfo

Ein Zeiger auf ein Array von POINTER_TYPE_INFO Strukturen, die die Zeigereingabedaten enthalten.

Zurückgegebener Wert

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben.

Wenn die Funktion fehlschlägt, wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Diese APIs funktionieren identisch mit ihren Gegenstücken ProcessPointerFramesInteractionContext und BufferPointerPacketsInteractionContext. Der einzige Unterschied besteht darin, einen POINTER_TYPE_INFO Puffer anstelle eines POINTER_INFO Puffers zu verwenden. Diese APIs ermöglichen es dem Interaktionskontext, die erweiterte Zeigerinformationennutzlast bei Bedarf zu verwenden.

Bei Touchpadeingaben müssen diese APIs anstelle ihrer Gegenstücke verwendet werden. Die erweiterten Informationen in der POINTER_TYPE_INFO Struktur sind für die richtige Touchpadgestenerkennung erforderlich.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 11 [nur Desktop-Apps]
Unterstützter Server (Mindestversion) Nicht unterstützt
Header InteractionContext.h
Bibliothek Ninput.lib
DLL Ninput.dll (Ordnungszahl 2507 für ProcessPointerFramesInteractionContext2, Ordinal 2508 für BufferPointerPacketsInteractionContext2)

Siehe auch