通过

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 缓冲区的大小（以 BYTE为单位）。

[in] pHintData

提示的其他数据。

此数据的格式取决于 renderHintType 参数中传递的值。

返回值

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 wtshintapi.h
Library WtsApi32.lib
DLL WtsApi32.dll