Fonction EngSetPointerTag (winddi.h)
La fonction EngSetPointerTag est obsolète pour Windows 2000 et versions ultérieures du système d’exploitation. Cette fonction est toujours prise en charge, mais retourne toujours FALSE.
EngSetPointerTag crée une forme qui est associée à la forme de pointeur de l’application sur les appels DrvSetPointerShape à d’autres pilotes associés dans un système mis en miroir.
Syntaxe
ENGAPI BOOL EngSetPointerTag(
[in] HDEV hdev,
[in] SURFOBJ *psoMask,
[in] SURFOBJ *psoColor,
[in] XLATEOBJ *pxlo,
[in] FLONG fl
);
Paramètres
[in] hdev
Gérer sur l’appareil. Ce handle est le handle GDI reçu par le pilote en tant que paramètre hdev pour DrvCompletePDEV.
[in] psoMask
Pointeur vers une structure SURFOBJ 1bpp qui décrit les composants monochromes de la balise. Les dimensions de cette bitmap déterminent la taille de la balise. Il n’existe aucune contrainte implicite sur la taille des étiquettes, mais les tailles d’étiquette optimales sont de 32 x 32, 48 x 48 et 64 x 64 pixels. GDI supprime la balise actuelle lorsque cette valeur est NULL.
[in] psoColor
Pointeur vers une structure SURFOBJ dans le même format de couleur que le pilote appelant. Cette valeur peut être NULL si la balise ne contient aucun composant de couleur. La bitmap de couleur a la même largeur que psoInputMask et la moitié de la hauteur.
[in] pxlo
Réservé à l’utilisation du système ; doit avoir la valeur NULL.
[in] fl
Réservé à l’utilisation du système ; doit être défini sur zéro.
Valeur retournée
EngSetPointerTag retourne TRUE lorsqu’il applique correctement la balise. Sinon, elle retourne FALSE. Pour Windows 2000 et versions ultérieures, cette fonction retourne toujours FALSE.
Remarques
Un pilote de contrôle à distance peut appeler EngSetPointerTag pour baliser une forme de pointeur afin de désigner le contrôle du système. Une fois que le pilote de contrôle à distance définit une balise, GDI la composite automatiquement avec toutes les formes de pointeur générées par le système, jusqu’à ce que le pilote supprime ou modifie la balise.
Le pilote qui appelle EngSetPointerShape n’obtient jamais sa propre balise appliquée à ses propres appels DrvSetPointerShape par GDI ; seuls les autres pilotes du système mis en miroir obtiennent l’étiquette appliquée.
Si psoColor a la valeur NULL, psoMask pointe vers une surface monochrome deux fois plus élevée que large. La moitié supérieure contient le masque ET monochrome, et la moitié inférieure contient le masque XOR monochrome.
Si psoColor n’a pas la valeur NULL, psoMask contient uniquement le masque AND monochrome et psoColor contient la surface XOR de couleur. Cette surface de couleur doit être au même format de couleur que le pilote. GDI joint les formes en ancreant les coins supérieurs gauches de chaque bitmap.
GDI effectue des copies de psoMask et psoColor, de sorte que les surfaces passées par le pilote peuvent être supprimées immédiatement après l’appel de EngSetPointerTag.
Les résultats d’EngSetPointerTag prennent effet sur l’appel de forme de pointeur suivant généré par le système.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | winddi.h (inclure Winddi.h) |
| Bibliothèque | Win32k.lib |
| DLL | Win32k.sys |