GetStateInteractionContext-Funktion (interactioncontext.h)

Ruft den aktuellen Kontextstatus der Interaktion ab.

Syntax

HRESULT GetStateInteractionContext(
  [in]           HINTERACTIONCONTEXT interactionContext,
  [in, optional] const POINTER_INFO  *pointerInfo,
  [out]          INTERACTION_STATE   *state
);

Die Parameter

[in] interactionContext

Zeiger auf ein Handle für den Interaktionskontext.

[in, optional] pointerInfo

Eine POINTER_INFO Struktur, die grundlegende Zeigerinformationen für den jeweiligen interessanten Zeiger enthält. Dieser Parameter kann NULL sein.

[out] state

Eine der Konstanten aus INTERACTION_STATE Enumeration.

Rückgabewert

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

Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Nachdem die Interaktion beendet wurde, kann der Interaktionskontext immer noch beschäftigt sein, die Unträgheit zu melden, oder es wird erwartet, dass der zweite Tipp in einer Doppeltippbewegung ausgeführt wird (im Allgemeinen, wenn eine Geste mit mehreren Strichen möglich ist). Mit dieser Funktion kann der Aufrufer herausfinden, wann es sicher ist, das Interaction Context-Objekt im Leerlauf zu behandeln. Der Hauptzweck dieser Funktion ist die Verwaltung von Pools von Interaktionskontexten.

Anforderungen