共用方式為

WTSSetRenderHint 函式 (wtshintapi.h)

  • 發行項

由顯示可優化在遠端會話中顯示之內容的應用程式使用，以識別屬於實際內容的窗口區域。

在遠端會話中，此內容會編碼、傳送至客戶端，然後譯碼並顯示。

語法

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

參數

[in, out] pRenderHintID

值地址，識別受這個呼叫影響的轉譯提示。 如果要建立新的提示，這個值必須包含零。 此函式會傳回用於後續呼叫的唯一轉譯提示標識碼，例如清除提示。

[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 和 Windows Server 2012 R2 之前，座標不會感知 DPI。

RENDER_HINT_MAPPEDWINDOW (2)

指出窗口對應是否存在。

pHintData 包含 RECT 結構，指定轉譯區域的座標和大小。 這些個別監視器 DPI 感知座標相對於 hwndOwner 參數所代表視窗的用戶端座標。

Windows 8 和 Windows Server 2012：Windows 8.1 和 Windows Server 2012 R2 之前，座標不會感知 DPI。

[in] cbHintDataLength

pHintData 緩衝區的大小，以 BYTEs 為單位。

[in] pHintData

提示的其他數據。

此數據的格式取決於 renderHintType 參數中傳遞的值。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
目標平台 Windows
標頭 wtshintapi.h
程式庫 WtsApi32.lib
Dll WtsApi32.dll