Funzione EngSetPointerTag (winddi.h)
La funzione EngSetPointerTag è obsoleta per windows 2000 e versioni successive del sistema operativo. Questa funzione è ancora supportata, ma restituisce sempre FALSE.
EngSetPointerTag crea una forma unita alla forma del puntatore dell'applicazione nelle chiamate DrvSetPointerShape ad altri driver associati in un sistema con mirroring.
Sintassi
ENGAPI BOOL EngSetPointerTag(
[in] HDEV hdev,
[in] SURFOBJ *psoMask,
[in] SURFOBJ *psoColor,
[in] XLATEOBJ *pxlo,
[in] FLONG fl
);
Parametri
[in] hdev
Gestire il dispositivo. Questo handle è l'handle GDI ricevuto dal driver come parametro hdev per DrvCompletePDEV.
[in] psoMask
Puntatore a una struttura SURFOBJ 1bpp che descrive i componenti monocromatici del tag. Le dimensioni di questa bitmap determinano le dimensioni del tag. Non esistono vincoli impliciti per le dimensioni dei tag, ma le dimensioni ottimali dei tag sono 32 x 32, 48 x 48 e 64 x 64 pixel. GDI rimuove il tag corrente quando questo valore è NULL.
[in] psoColor
Puntatore a una struttura SURFOBJ nello stesso formato di colore del driver chiamante. Questo valore può essere NULL se il tag non contiene componenti di colore. La bitmap del colore ha la stessa larghezza dello psoInputMask e metà dell'altezza.
[in] pxlo
Riservato per l'uso del sistema; deve essere impostato su NULL.
[in] fl
Riservato per l'uso del sistema; deve essere impostato su zero.
Valore restituito
EngSetPointerTag restituisce TRUE quando si applica correttamente il tag. In caso contrario, restituisce FALSE. Per Windows 2000 e versioni successive, questa funzione restituisce sempre FALSE.
Commenti
Un driver di controllo remoto può chiamare EngSetPointerTag per contrassegnare una forma puntatore per indicare il controllo del sistema. Dopo che il driver di controllo remoto imposta un tag, GDI lo composite automaticamente con tutte le forme del puntatore generate dal sistema, fino a quando il driver non rimuove o modifica il tag.
Il driver che chiama EngSetPointerShape non ottiene mai il proprio tag applicato alle proprie chiamate DrvSetPointerShape da GDI; vengono applicati solo altri driver nel sistema con mirroring.
Se psoColor è NULL, psoMask punta a una superficie monocromatica che è due volte più alta di quanto sia ampia. La metà superiore contiene la maschera E monocromatica e la metà inferiore contiene la maschera XOR monocromatica.
Se psoColor non è NULL, psoMask contiene solo la maschera E monocromatica e psoColor contiene la superficie XOR del colore. Questa superficie di colore deve essere nello stesso formato di colore del driver. GDI aggiunge le forme ancorando gli angoli in alto a sinistra di ogni bitmap.
GDI crea copie di psoMask e psoColor, quindi le superfici passate dal driver possono essere eliminate immediatamente dopo aver chiamato EngSetPointerTag.
I risultati di EngSetPointerTag hanno effetto sulla chiamata di forma del puntatore successiva generata dal sistema.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | winddi.h (include Winddi.h) |
| Libreria | Win32k.lib |
| DLL | Win32k.sys |