Freigeben über

GetPointerTouchInfoHistory-Funktion (winuser.h)

  • Artikel

Ruft die touchbasierten Informationen ab, die den einzelnen Eingaben zugeordnet sind, sofern vorhanden, die in der aktuellen Nachricht für den angegebenen Zeiger (vom Typ PT_TOUCH) zusammengefasst wurden. Die letzte Eingabe ist im zurückgegebenen Verlauf enthalten und entspricht der letzten Eingabe, die von der GetPointerTouchInfo-Funktion zurückgegeben wird.

Syntax

BOOL GetPointerTouchInfoHistory(
  [in]            UINT32             pointerId,
  [in, out]       UINT32             *entriesCount,
  [out, optional] POINTER_TOUCH_INFO *touchInfo
);

Parameter

[in] pointerId

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

[in, out] entriesCount

Ein Zeiger auf eine Variable, die die Anzahl der Strukturen im Puffer angibt, auf die touchInfo verweist. Wenn GetPointerTouchInfoHistory erfolgreich ist, wird entriesCount mit der Gesamtanzahl der verfügbaren Strukturen aktualisiert. Die Gesamtanzahl der verfügbaren Strukturen entspricht dem Feld historyCount in der POINTER_INFO-Struktur , die von einem Aufruf von GetPointerInfo oder GetPointerTouchInfo zurückgegeben wird.

[out, optional] touchInfo

Adresse eines Arrays von POINTER_TOUCH_INFO Strukturen, um die Zeigerinformationen zu empfangen. Dieser Parameter kann NULL sein, wenn *entriesCount null ist.

Rückgabewert

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

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

Hinweise

Wenn die Anwendung Zeigereingabenachrichten nicht so schnell verarbeitet, wie sie generiert werden, werden einige Verschiebungen möglicherweise zusammengezeigt. Wenn eine Anwendung eine Zusammenführungszeigernachricht (vom Typ PT_TOUCH) empfängt, kann sie die GetPointerTouchInfoHistory-Funktion verwenden, um Informationen für alle einzelnen Eingaben abzurufen, sofern vorhanden, die in der Nachricht zusammengeführt wurden. Beachten Sie, dass die abgerufenen Informationen der Zeigermeldung zugeordnet sind, die zuletzt vom aufrufenden Thread abgerufen wurde. Sobald der aufrufende Thread seine nächste Nachricht abruft, sind die informationen, die der vorherigen Nachricht zugeordnet sind, möglicherweise nicht mehr verfügbar.

Die abgerufenen Informationen werden in umgekehrter chronologischer Reihenfolge angezeigt, wobei der letzte Eintrag in der ersten Zeile des zurückgegebenen Arrays enthalten ist. Der letzte Eintrag entspricht dem eintrag, der von der GetPointerTouchInfo-Funktion zurückgegeben wird.

Wenn die Anzahl der Zeilen im bereitgestellten Puffer nicht ausreicht, um alle verfügbaren Verlaufseinträge zu speichern, ist diese Funktion erfolgreich, wobei der Puffer die letzten Einträge und *entriesCount die Gesamtzahl der verfügbaren Einträge enthält.

Wenn der Zeigerrahmen neben dem angegebenen Zeiger keine zusätzlichen Zeiger enthält, ist diese Funktion erfolgreich und gibt nur die Informationen für den angegebenen Zeiger zurück.

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

Wenn der aufrufende Thread nicht der Besitzer des Fensters ist (in dem die Eingabe ursprünglich übermittelt wurde oder in dem die Nachricht weitergeleitet wurde), an das die Zeigernachricht übermittelt wurde, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_ACCESS_DENIED festgelegt ist.

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 (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll

Siehe auch

Funktionen

GetPointerFrameTouchInfo

GetPointerFrameTouchInfoHistory

GetPointerTouchInfo