Função EngSetPointerTag (winddi.h)
A função EngSetPointerTag está obsoleta para o Windows 2000 e versões posteriores do sistema operacional. Essa função ainda tem suporte, mas sempre retorna FALSE.
EngSetPointerTag cria uma forma que é uniãoda com a forma de ponteiro do aplicativo em chamadas DrvSetPointerShape para outros drivers associados em um sistema espelhado.
Sintaxe
ENGAPI BOOL EngSetPointerTag(
[in] HDEV hdev,
[in] SURFOBJ *psoMask,
[in] SURFOBJ *psoColor,
[in] XLATEOBJ *pxlo,
[in] FLONG fl
);
Parâmetros
[in] hdev
Identificador para o dispositivo. Esse identificador é o identificador GDI recebido pelo driver como o parâmetro hdev para DrvCompletePDEV.
[in] psoMask
Ponteiro para uma estrutura SURFOBJ de 1bpp que descreve os componentes monocromáticos da marca. As dimensões desse bitmap determinam o tamanho da marca. Não há restrições implícitas em tamanhos de marca, mas os tamanhos de marca ideais são 32 x 32, 48 x 48 e 64 x 64 pixels. A GDI remove a marca atual quando esse valor é NULL.
[in] psoColor
Ponteiro para uma estrutura SURFOBJ no mesmo formato de cor que o driver de chamada. Esse valor poderá ser NULL se a marca não contiver nenhum componente de cor. O bitmap de cor tem a mesma largura que psoInputMask e metade da altura.
[in] pxlo
Reservado para uso do sistema; deve ser definido como NULL.
[in] fl
Reservado para uso do sistema; deve ser definido como zero.
Retornar valor
EngSetPointerTag retorna TRUE quando aplica a marca com êxito. Caso contrário, retornará FALSE. Para o Windows 2000 e posterior, essa função sempre retorna FALSE.
Comentários
Um driver de controle remoto pode chamar EngSetPointerTag para marcar uma forma de ponteiro para denotar o controle do sistema. Depois que o driver de controle remoto definir uma marca, o GDI a comporá automaticamente com todas as formas de ponteiro geradas pelo sistema, até que o driver remova ou altere a marca.
O driver que chama EngSetPointerShape nunca obtém sua própria marca aplicada às suas próprias chamadas DrvSetPointerShape pela GDI; somente outros drivers no sistema espelhado obtêm a marca aplicada.
Se psoColor for NULL, psoMask apontará para uma superfície monocromática que é duas vezes mais alta que a largura. A metade superior contém a máscara AND monocromática e a metade inferior contém a máscara XOR monocromática.
Se psoColor não for NULL, psoMask conterá apenas a máscara AND monocromática e psoColor conterá a superfície XOR de cor. Essa superfície de cor deve estar no mesmo formato de cor que o driver. A GDI une as formas ancorando os cantos superiores esquerdos de cada bitmap.
A GDI faz cópias de psoMask e psoColor, para que as superfícies passadas pelo driver possam ser excluídas imediatamente após chamar EngSetPointerTag.
Os resultados de EngSetPointerTag entrarão em vigor na próxima chamada de forma de ponteiro gerada pelo sistema.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | winddi.h (inclua Winddi.h) |
| Biblioteca | Win32k.lib |
| DLL | Win32k.sys |