Función EngSetPointerTag (winddi.h)
La función EngSetPointerTag está obsoleta para windows 2000 y versiones posteriores del sistema operativo. Esta función sigue siendo compatible, pero siempre devuelve FALSE.
EngSetPointerTag crea una forma que se une con la forma de puntero de la aplicación en drvSetPointerShape llama a otros controladores asociados en un sistema reflejado.
Sintaxis
ENGAPI BOOL EngSetPointerTag(
[in] HDEV hdev,
[in] SURFOBJ *psoMask,
[in] SURFOBJ *psoColor,
[in] XLATEOBJ *pxlo,
[in] FLONG fl
);
Parámetros
[in] hdev
Identificador del dispositivo. Este identificador es el identificador GDI recibido por el controlador como parámetro hdev para DrvCompletePDEV.
[in] psoMask
Puntero a una estructura SURFOBJ de 1bpp que describe los componentes monocromáticos de la etiqueta. Las dimensiones de este mapa de bits determinan el tamaño de la etiqueta. No hay restricciones implícitas en los tamaños de etiqueta, pero los tamaños de etiqueta óptimos son 32 x 32, 48 x 48 y 64 x 64 píxeles. GDI quita la etiqueta actual cuando este valor es NULL.
[in] psoColor
Puntero a una estructura SURFOBJ con el mismo formato de color que el controlador que llama. Este valor puede ser NULL si la etiqueta no contiene componentes de color. El mapa de bits de color tiene el mismo ancho que pixelInputMask y la mitad del alto.
[in] pxlo
Reservado para uso del sistema; debe establecerse en NULL.
[in] fl
Reservado para uso del sistema; debe establecerse en cero.
Valor devuelto
EngSetPointerTag devuelve TRUE cuando se aplica correctamente la etiqueta. De lo contrario, devuelve FALSE. Para Windows 2000 y versiones posteriores, esta función siempre devuelve FALSE.
Comentarios
Un controlador de control remoto puede llamar a EngSetPointerTag para etiquetar una forma de puntero para indicar el control del sistema. Una vez que el controlador de control remoto establece una etiqueta, GDI la componerá automáticamente con todas las formas de puntero generadas por el sistema, hasta que el controlador quite o cambie la etiqueta.
El controlador que llama a EngSetPointerShape nunca obtiene su propia etiqueta aplicada a sus propias llamadas DrvSetPointerShape por GDI; solo otros controladores del sistema reflejado obtienen la etiqueta aplicada.
Si dbColor es NULL, el valor de ppMask apunta a una superficie monocromática que es el doble de alto que es ancha. La mitad superior contiene la máscara AND monocromática y la mitad inferior contiene la máscara XOR monocromática.
Si dbColor no es NULL, ppMask contiene solo la máscara Y monocromática Y y ppColor contiene la superficie XOR de color. Esta superficie de color debe tener el mismo formato de color que el controlador. GDI combina las formas anclando las esquinas superior izquierda de cada mapa de bits.
GDI realiza copiasdes y colorcolor, por lo que las superficies pasadas por el controlador se pueden eliminar inmediatamente después de llamar a EngSetPointerTag.
Los resultados de EngSetPointerTag surten efecto en la siguiente llamada de forma de puntero generada por el sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |