GetPointerInfo-Funktion (winuser.h)

Ruft die Informationen für den angegebenen Zeiger ab, der der aktuellen Nachricht zugeordnet ist.

Hinweis Verwenden Sie GetPointerType , wenn Sie die von GetPointerInfo verfügbar gemachten zusätzlichen Informationen nicht benötigen.

 

Syntax

BOOL GetPointerInfo(
  [in]  UINT32       pointerId,
  [out] POINTER_INFO *pointerInfo
);

Parameter

[in] pointerId

Der Zeigerbezeichner.

[out] pointerInfo

Adresse einer POINTER_INFO Struktur, die die Zeigerinformationen empfängt.

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

GetPointerInfo ruft Informationen für einen einzelnen Zeiger ab, der einer Zeigernachricht zugeordnet ist.

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

Die von GetPointerInfo 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 GetPointerInfoHistory , 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.

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
APIs	ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Funktionen

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfoHistory