Funzione SkipPointerFrameMessages (winuser.h)

Determina quale frame di input del puntatore ha generato il messaggio recuperato più di recente per il puntatore specificato e rimuove i messaggi di input del puntatore in coda (non registrati) generati dallo stesso frame di input del puntatore. Se un'applicazione ha recuperato informazioni per un intero frame usando la funzione GetPointerFrameInfo, la funzione GetPointerFrameInfoHistory o una delle varianti specifiche del tipo, può usare questa funzione per evitare il recupero e l'eliminazione di messaggi rimanenti da tale frame uno per uno.

Sintassi

BOOL SkipPointerFrameMessages(
  [in] UINT32 pointerId
);

Parametri

[in] pointerId

Identificatore del puntatore. I messaggi in sospeso verranno ignorati per il frame che include l'input recuperato più di recente per questo puntatore.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

I dispositivi in modalità parallela possono segnalare l'input del puntatore nei fotogrammi, ovvero possono segnalare lo stato e la posizione di tutti i puntatori da tale dispositivo in un singolo report di input al sistema. Idealmente, le applicazioni devono visualizzare l'intero frame come singolo input, a meno che i requisiti specifici dell'applicazione non determinino altrimenti.

La funzione SkipPointerFrameMessages può essere usata insieme alla funzione GetPointerFrameInfo (o una delle varianti specifiche del tipo) per utilizzare interi frame come singolo input.

Quando un'applicazione visualizza un messaggio di puntatore, può usare la funzione GetPointerFrameInfo per recuperare l'intero frame di input del puntatore a cui appartiene il messaggio del puntatore, ottenendo quindi una visualizzazione aggiornata di tutti i puntatori attualmente di proprietà della finestra. Si noti che il frame restituito contiene solo puntatori attualmente di proprietà della stessa finestra del puntatore specificato.

Dopo aver recuperato l'intero frame di informazioni, l'applicazione può quindi chiamare la funzione SkipPointerFrameMessages per ignorare i messaggi del puntatore rimanenti associati a questo frame in sospeso. In questo modo l'applicazione salva il sovraccarico del recupero e dell'elaborazione dei messaggi rimanenti uno per uno.

Avviso La funzione SkipPointerFrameMessages deve essere usata solo quando il chiamante può essere sicuro che nessun'altra entità nel thread del chiamante (ad esempio Manipolazione diretta) si aspetta di recuperare messaggi puntatori in sospeso. Per questo motivo , SkipPointerFrameMessages non deve essere usato insieme alla manipolazione diretta durante l'elaborazione di più interazioni simultanee.

 

Si noti che le informazioni recuperate sono associate al frame del puntatore di recente recuperato dal thread chiamante. Una volta recuperato il messaggio successivo, le informazioni associate al frame del puntatore precedente potrebbero non essere più disponibili.

Se il frame del puntatore non contiene puntatori aggiuntivi oltre al puntatore specificato, questa funzione ha esito positivo senza alcuna azione.

Se il thread chiamante non possiede la finestra a cui è stato recapitato il messaggio del puntatore, questa funzione non riesce con l'ultimo errore impostato su ERROR_ACCESS_DENIED.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll

Vedi anche

Funzioni