Функция WTSSetRenderHint (wthintapi.h)

Статья
03/13/2024

Используется приложением, отображающим содержимое, которое может быть оптимизировано для отображения в удаленном сеансе, чтобы определить область окна, которая является фактическим содержимым.

В удаленном сеансе это содержимое будет кодироваться, отправляться клиенту, а затем декодироваться и отображаться.

Синтаксис

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. Координаты не поддерживают DPI перед Windows 8.1 и Windows Server 2012 R2.

RENDER_HINT_MAPPEDWINDOW (2)

Указывает на наличие сопоставления окон.

Windows 8 и Windows Server 2012. Координаты не поддерживают DPI перед Windows 8.1 и Windows Server 2012 R2.

[in] cbHintDataLength

Размер буфера pHintData в BYTE.

[in] pHintData

Дополнительные данные для указания.

Формат этих данных зависит от значения, переданного в параметре renderHintType .

Возвращаемое значение

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Минимальная версия сервера	Windows Server 2012
Целевая платформа	Windows
Header	wtshintapi.h
Библиотека	WtsApi32.lib
DLL	WtsApi32.dll

Поделиться через