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

デバイスへのハンドル。 このハンドルは、ドライバーが DrvCompletePDEV の hdev パラメーターとして受け取る GDI ハンドルです。

[in] psoMask

タグのモノクロ コンポーネントを記述する 1bpp SURFOBJ 構造体へのポインター。 このビットマップの寸法によって、タグのサイズが決まります。 タグ サイズには暗黙的な制約はありませんが、最適なタグ サイズは 32 x 32、48 x 48、64 x 64 ピクセルです。 GDI は、この値が NULL の場合に現在のタグを削除 します。

[in] psoColor

呼び出し元ドライバーと同じ色形式の SURFOBJ 構造体へのポインター。 タグに色コンポーネントが含まれない場合、この値は NULL にすることができます。 カラー ビットマップの幅は psoInputMask と同じで、高さは半分です。

[in] pxlo

システムの使用のために予約されています。 は NULL に設定する必要があります。

[in] fl

システムの使用のために予約されています。は 0 に設定する必要があります。

戻り値

EngSetPointerTag は、 タグが正常に適用されると TRUE を 返します。 それ以外の場合は、 FALSE を返します。 Windows 2000 以降の場合、この関数は常に FALSE を返します。

注釈

リモート コントロール ドライバーは 、EngSetPointerTag を呼び出して、システムの制御を示すポインター図形にタグを付けることができます。 リモート コントロール ドライバーがタグを設定すると、GDI は、ドライバーがタグを削除または変更するまで、システムによって生成されたすべてのポインター図形と自動的に複合されます。

EngSetPointerShape を呼び出すドライバーは、GDI による独自の DrvSetPointerShape 呼び出しに適用される独自のタグを取得することはありません。ミラー化されたシステム内の他のドライバーのみがタグを適用します。

psoColor が NULL の場合、psoMask は、幅の 2 倍の高さであるモノクロサーフェスを指します。 上半分にはモノクロとマスクが含まれており、下半分にはモノクロXORマスクが含まれています。

psoColor が NULL でない場合、psoMask にはモノクロの AND マスクのみが含まれており、psoColor にはカラー XOR サーフェスが含まれます。 このカラー サーフェスは、ドライバーと同じ色形式である必要があります。 GDI は、各ビットマップの左上隅を固定して図形を結合します。

GDI は psoMask と psoColor のコピーを作成するため、ドライバーによって渡されたサーフェスは、EngSetPointerTag を呼び出した直後に削除できます。

EngSetPointerTag の結果は、システムによって生成される次のポインター図形呼び出しで有効になります。

要件

こちらもご覧ください

DrvSetPointerShape

EngSetPointerShape

SURFOBJ