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 的結果會在系統產生的下一個指標圖形呼叫上生效。

規格需求

另請參閱

DrvSetPointerShape

EngSetPointerShape

SURFOBJ