GetPointerInfoHistory-Funktion (winuser.h)

Ruft die Informationen ab, die den einzelnen Eingaben zugeordnet sind, falls vorhanden, die in der aktuellen Nachricht für den angegebenen Zeiger zusammengefasst wurden. Die neueste Eingabe ist im zurückgegebenen Verlauf enthalten und entspricht der letzten Eingabe, die von der GetPointerInfo-Funktion zurückgegeben wird.

Syntax

BOOL GetPointerInfoHistory(
  [in]            UINT32       pointerId,
  [in, out]       UINT32       *entriesCount,
  [out, optional] POINTER_INFO *pointerInfo
);

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 pointerInfo verweist. Wenn GetPointerInfoHistory erfolgreich ist, wird entriesCount mit der Gesamtzahl der verfügbaren Strukturen aktualisiert. Die Gesamtanzahl der verfügbaren Strukturen entspricht dem Feld historyCount der POINTER_INFO Struktur, die durch einen Aufruf von GetPointerInfo zurückgegeben wird.

[out, optional] pointerInfo

Adresse eines Arrays von POINTER_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.

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, können einige Verschiebungen zusammengezeigt werden. Wenn eine Anwendung eine koaleszierbare Zeigernachricht empfängt, kann sie die GetPointerInfoHistory-Funktion verwenden, um Informationen für alle einzelnen Eingaben abzurufen, falls vorhanden, die in der Nachricht zusammengefasst wurden. Beachten Sie, dass die abgerufenen Informationen der zuletzt vom aufrufenden Thread abgerufenen Zeigernachricht zugeordnet sind. 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 mit dem letzten Eintrag in der ersten Zeile des zurückgegebenen Arrays angezeigt. Der neueste Eintrag ist mit dem von der GetPointerInfo-Funktion zurückgegebenen Eintrag identisch.

Wenn die Anzahl der Zeilen im bereitgestellten Puffer nicht ausreicht, um alle verfügbaren Verlaufseinträge aufzunehmen, ist diese Funktion erfolgreich, wenn der Puffer die neuesten Einträge und *entriesCount enthält, die die Gesamtanzahl der verfügbaren Einträge enthält.

Wenn der Zeigerrahmen neben dem angegebenen Zeiger keine weiteren 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, wobei der letzte Fehler auf ERROR_NO_DATA festgelegt ist.

Wenn der aufrufende Thread nicht im Besitz des Fensters ist (in dem die Eingabe ursprünglich übermittelt wurde oder an 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.

Anforderungen

Anforderung	Wert
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

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfo