EngSetPointerTag 函式 (winddi.h)
EngSetPointerTag 函式已過時，適用於 Windows 2000 和更新版本的作業系統版本。 仍然支援此函式，但一律會傳回 FALSE。
EngSetPointerTag 會建立與 DrvSetPointerShape 上應用程式指標圖形聯集的圖形，呼叫鏡像系統中的其他相關聯驅動程式。
語法
ENGAPI BOOL EngSetPointerTag(
[in] HDEV hdev,
[in] SURFOBJ *psoMask,
[in] SURFOBJ *psoColor,
[in] XLATEOBJ *pxlo,
[in] FLONG fl
);
參數
[in] hdev
裝置的句柄。 此句柄是驅動程式接收的 GDI 句柄，作為DrvCompletePDEV的 hdev 參數。
[in] psoMask
描述標籤單色元件的 1bpp SURFOBJ 結構的指標。 這個點陣圖的維度會決定標籤的大小。 卷標大小沒有隱含條件約束，但最佳標籤大小為 32 x 32、48 x 48 和 64 x 64 像素。 當此值為 NULL 時，GDI 會移除目前的標記。
[in] psoColor
與呼叫驅動程式相同色彩格式的 SURFOBJ 結構的指標。 如果標籤不包含色彩元件，這個值可以是 NULL 。 色彩點圖的寬度與 psoInputMask 相同，高度為一半。
[in] pxlo
保留供系統使用;必須設定為 NULL。
[in] fl
保留供系統使用;必須設定為零。
傳回值
當 EngSetPointerTag 成功套用標籤時，會傳回 TRUE 。 否則會傳回 FALSE。 針對 Windows 2000 和更新版本，此函式一律會傳回 FALSE。
備註
遠端控制驅動程式可以呼叫 EngSetPointerTag 來標記指標圖形，以表示系統的控件。 一旦遠端控制驅動程式設定標籤之後，GDI 會自動將其與系統產生的所有指標圖形進行複合，直到驅動程式移除或變更標籤為止。
呼叫 EngSetPointerShape 的驅動程序永遠不會取得套用至 GDI 所呼叫自己的 DrvSetPointerShape 呼叫的標記;只有鏡像系統中的其他驅動程式才會套用標記。
如果 psoColor 為 NULL，psoMask 會指向寬度與寬度一樣高兩倍的單色表面。 上半部包含單色 AND 遮罩，下半部則包含單色 XOR 遮罩。
如果 psoColor 不是 NULL，psoMask 只包含單色 AND 遮罩，而 psoColor 則包含色彩 XOR 表面。 此色彩介面必須與驅動程式具有相同的色彩格式。 GDI 會藉由錨定每個點陣圖的左上角來聯結圖形。
GDI 會複製 psoMask 和 psoColor，因此驅動程式傳入的介面可以在呼叫 EngSetPointerTag 之後立即刪除。
EngSetPointerTag 的結果會在系統產生的下一個指標圖形呼叫上生效。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows 2000 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | Universal |
| 標頭 | winddi.h (包括 Winddi.h) |
| 程式庫 | Win32k.lib |
| Dll | Win32k.sys |