GetPointerTouchInfo-Funktion (winuser.h)

Ruft die touchbasierten Informationen für den angegebenen Zeiger (vom Typ PT_TOUCH) ab, der der aktuellen Nachricht zugeordnet ist.

Syntax

BOOL GetPointerTouchInfo(
  [in]  UINT32             pointerId,
  [out] POINTER_TOUCH_INFO *touchInfo
);

Parameter

[in] pointerId

Ein Bezeichner des Zeigers, für den Informationen abgerufen werden sollen.

[out] touchInfo

Adresse einer POINTER_TOUCH_INFO Struktur, um die touchspezifischen Zeigerinformationen zu erhalten.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich 0.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

GetPointerTouchInfo ruft Informationen für einen einzelnen Zeiger (vom Typ PT_TOUCH) ab, der einer Zeigernachricht zugeordnet ist.

Verwenden Sie GetPointerFrameTouchInfo , um Frameinformationen abzurufen, die einer Nachricht für eine Reihe von Zeigern zugeordnet sind.

Die von GetPointerTouchInfo zurückgegebenen Informationen sind der neuesten Zeigernachricht zugeordnet, die vom aufrufenden Thread abgerufen wurde. Wenn die nächste Nachricht vom aufrufenden Thread abgerufen wird, sind die informationen, die der vorherigen Nachricht zugeordnet sind, möglicherweise nicht mehr verfügbar.

Wenn die Anwendung Zeigereingabenachrichten nicht so schnell verarbeitet, wie sie generiert werden, werden einige Nachrichten möglicherweise zu einer WM_POINTERUPDATE Nachricht zusammengefasst. Verwenden Sie GetPointerTouchInfoHistory , um den Nachrichtenverlauf aus der neuesten WM_POINTERUPDATE Nachricht abzurufen.

Wenn die der Nachricht zugeordneten Informationen nicht mehr verfügbar sind, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_NO_DATA festgelegt ist.

Wenn der aufrufende Thread nicht im Besitz des Fensters ist, in das die Zeigernachricht gesendet wurde, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_ACCESS_DENIED festgelegt ist. Beachten Sie, dass dies das Fenster sein kann, an das die Eingabe ursprünglich übermittelt wurde, oder ein Fenster, an das die Nachricht weitergeleitet wurde.

Wenn der angegebene Zeiger nicht vom Typ PT_TOUCH ist, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_DATATYPE_MISMATCH festgelegt ist.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll

Siehe auch

Funktionen

GetPointerFrameTouchInfo

GetPointerFrameTouchInfoHistory

GetPointerTouchInfoHistory