EngSetPointerTag-Funktion (winddi.h)

Die EngSetPointerTag-Funktion ist für Windows 2000 und höhere Betriebssystemversionen veraltet . Diese Funktion wird weiterhin unterstützt, gibt aber immer FALSE zurück.

EngSetPointerTag erstellt eine Form, die mit dem Zeiger-Shape der Anwendung auf DrvSetPointerShape-Aufrufen anderer zugeordneter Treiber in einem gespiegelten System verbunden ist.

Syntax

ENGAPI BOOL EngSetPointerTag(
  [in] HDEV     hdev,
  [in] SURFOBJ  *psoMask,
  [in] SURFOBJ  *psoColor,
  [in] XLATEOBJ *pxlo,
  [in] FLONG    fl
);

Parameter

[in] hdev

Handle mit dem Gerät. Dieses Handle ist das GDI-Handle, das vom Treiber als hdev-Parameter für DrvCompletePDEV empfangen wird.

[in] psoMask

Zeiger auf eine 1bpp SURFOBJ-Struktur , die die monochromen Komponenten des Tags beschreibt. Die Dimensionen dieser Bitmap bestimmen die Größe des Tags. Es gibt keine impliziten Einschränkungen für Taggrößen, aber die optimalen Taggrößen sind 32 x 32, 48 x 48 und 64 x 64 Pixel. GDI entfernt das aktuelle Tag, wenn dieser Wert NULL ist.

[in] psoColor

Zeiger auf eine SURFOBJ-Struktur im gleichen Farbformat wie der aufrufende Treiber. Dieser Wert kann NULL sein, wenn das Tag keine Farbkomponenten enthält. Die Farbbittei hat die gleiche Breite wie psoInputMask und die halbe Höhe.

[in] pxlo

Für die Systemnutzung reserviert; muss auf NULL festgelegt werden.

[in] fl

Für die Systemnutzung reserviert; muss auf 0 festgelegt werden.

Rückgabewert

EngSetPointerTag gibt TRUE zurück, wenn das Tag erfolgreich angewendet wird. Andernfalls wird FALSE zurückgegeben. Für Windows 2000 und höher gibt diese Funktion immer FALSE zurück.

Hinweise

Ein Remotesteuerungstreiber kann EngSetPointerTag aufrufen, um eine Zeigerform zu markieren, um die Steuerung des Systems anzugeben. Sobald der Remotesteuerungstreiber ein Tag festlegt, wird es von GDI automatisch mit allen vom System generierten Zeigerformen zusammengesetzt, bis der Treiber das Tag entfernt oder ändert.

Der Treiber, der EngSetPointerShape aufruft , erhält nie ein eigenes Tag, das von GDI auf seine eigenen DrvSetPointerShape-Aufrufe angewendet wird. nur andere Treiber im gespiegelten System erhalten das Tag angewendet.

Wenn psoColorNULL ist, zeigt psoMask auf eine monochrome Oberfläche, die doppelt so hoch ist wie breit. Die obere Hälfte enthält die monochrome AND-Maske und die untere Hälfte die monochrome XOR-Maske.

Wenn psoColor nicht NULL ist, enthält psoMask nur die monochrome AND-Maske und psoColor die XOR-Farboberfläche. Diese Farboberfläche muss im gleichen Farbformat wie der Treiber vorliegen. GDI verknüpft die Shapes, indem die oberen linken Ecken jeder Bitmap verankert werden.

GDI erstellt Kopien von psoMask und psoColor, sodass die vom Treiber übergebenen Oberflächen sofort nach dem Aufruf von EngSetPointerTag gelöscht werden können.

Die Ergebnisse von EngSetPointerTag werden auf den nächsten Aufruf der Zeigerform wirksam, der vom System generiert wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys

Weitere Informationen

DrvSetPointerShape

EngSetPointerShape

SURFOBJ