Freigeben über

GetPointerPenInfoHistory-Funktion (winuser.h)

  • Artikel

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

Syntax

BOOL GetPointerPenInfoHistory(
  [in]            UINT32           pointerId,
  [in, out]       UINT32           *entriesCount,
  [out, optional] POINTER_PEN_INFO *penInfo
);

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 penInfo verweist. Wenn GetPointerPenInfoHistory 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_PEN_INFO Struktur, die durch einen Aufruf von GetPointerPenInfo zurückgegeben wird.

[out, optional] penInfo

Adresse eines Arrays von POINTER_PEN_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 einen koessierbaren Zeiger (vom Typ PT_PEN) empfängt, kann sie die GetPointerPenInfoHistory-Funktion verwenden, um Informationen für alle einzelnen Eingaben abzurufen, falls vorhanden, die in die Nachricht integriert 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 GetPointerPenInfo-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.

Wenn der angegebene Zeiger nicht vom Typ PT_PEN ist, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_DATATYPE_MISMATCH 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

GetPointerFramePenInfo

GetPointerFramePenInfoHistory

GetPointerPenInfo