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 |