WTSSetRenderHint 関数 (wtshintapi.h)

実際のコンテンツであるウィンドウの領域を識別するためにリモート セッションでの表示用に最適化できるコンテンツを表示するアプリケーションによって使用されます。

リモート セッションでは、このコンテンツはエンコードされ、クライアントに送信され、デコードされて表示されます。

構文

HRESULT WTSSetRenderHint(
  [in, out] UINT64 *pRenderHintID,
  [in]      HWND   hwndOwner,
  [in]      DWORD  renderHintType,
  [in]      DWORD  cbHintDataLength,
  [in]      BYTE   *pHintData
);

パラメーター

[in, out] pRenderHintID

この呼び出しの影響を受けるレンダリング ヒントを識別する値のアドレス。 新しいヒントを作成する場合、この値には 0 を含む必要があります。 この関数は、ヒントのクリアなど、後続の呼び出しに使用される一意のレンダリング ヒント識別子を返します。

[in] hwndOwner

レンダリング ヒントの有効期間にリンクされたウィンドウのハンドル。 このウィンドウは、ヒントターゲットが明示的にクリアされずに削除される状況で使用されます。

[in] renderHintType

この呼び出しで表されるヒントの種類を指定します。

RENDER_HINT_CLEAR (0)

前のヒントはクリアされます。

pHintData は NULL である必要があります。

RENDER_HINT_VIDEO (1)

ビデオの移動の有無を示します。

pHintData には、レンダリング領域の座標とサイズを指定する RECT 構造体が含まれています。 これらのモニターごとの DPI 対応座標は、 hwndOwner パラメーターで表されるウィンドウのクライアント座標に対して相対的です。

Windows 8とWindows Server 2012: 座標は、Windows 8.1して R2 をWindows Server 2012する前に DPI 対応ではありません。

RENDER_HINT_MAPPEDWINDOW (2)

ウィンドウ マッピングの存在を示します。

pHintData には、レンダリング領域の座標とサイズを指定する RECT 構造体が含まれています。 これらのモニターごとの DPI 対応座標は、 hwndOwner パラメーターで表されるウィンドウのクライアント座標に対して相対的です。

Windows 8とWindows Server 2012: 座標は、Windows 8.1して R2 をWindows Server 2012する前に DPI 対応ではありません。

[in] cbHintDataLength

pHintData バッファーのバイト単位のサイズ。

[in] pHintData

ヒントの追加データ。

このデータの形式は、 renderHintType パラメーターで渡された値によって異なります。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件	値
サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	Windows
ヘッダー	wtshintapi.h
Library	WtsApi32.lib
[DLL]	WtsApi32.dll