Função WTSSetRenderHint (wtshintapi.h)

Artigo
03/13/2024

Usado por um aplicativo que está exibindo conteúdo que pode ser otimizado para exibição em uma sessão remota para identificar a região de uma janela que é o conteúdo real.

Na sessão remota, esse conteúdo será codificado, enviado ao cliente e, em seguida, decodificado e exibido.

Sintaxe

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

Parâmetros

[in, out] pRenderHintID

O endereço de um valor que identifica a dica de renderização afetada por essa chamada. Se uma nova dica estiver sendo criada, esse valor deverá conter zero. Essa função retornará um identificador de dica de renderização exclusivo que é usado para chamadas subsequentes, como limpar a dica.

[in] hwndOwner

O identificador da janela vinculada ao tempo de vida da dica de renderização. Essa janela é usada em situações em que um destino de dica é removido sem que a dica seja explicitamente limpa.

[in] renderHintType

Especifica o tipo de dica representado por essa chamada.

RENDER_HINT_CLEAR (0)

A dica anterior está desmarcada.

pHintData deve ser NULL.

RENDER_HINT_VIDEO (1)

Indica a presença de vídeo móvel.

pHintData contém uma estrutura RECT que especifica as coordenadas e o tamanho da área de renderização. Essas coordenadas com reconhecimento de DPI por monitor são relativas às coordenadas do cliente da janela representada pelo parâmetro hwndOwner .

Windows 8 e Windows Server 2012: as coordenadas não têm reconhecimento de DPI antes de Windows 8.1 e Windows Server 2012 R2.

RENDER_HINT_MAPPEDWINDOW (2)

Indica a presença de um mapeamento de janela.

Windows 8 e Windows Server 2012: as coordenadas não têm reconhecimento de DPI antes de Windows 8.1 e Windows Server 2012 R2.

[in] cbHintDataLength

O tamanho, em BYTEs, do buffer pHintData .

[in] pHintData

Dados adicionais para a dica.

O formato desses dados depende do valor passado no parâmetro renderHintType .

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Windows
Cabeçalho	wtshintapi.h
Biblioteca	WtsApi32.lib
DLL	WtsApi32.dll

Partilhar via