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

Confira também

DrvSetPointerShape

EngSetPointerShape

SURFOBJ