Fonction WTSSetRenderHint (wtshintapi.h)

Article
03/09/2024

Utilisé par une application qui affiche du contenu qui peut être optimisé pour l’affichage dans une session distante afin d’identifier la région d’une fenêtre qui est le contenu réel.

Dans la session à distance, ce contenu est encodé, envoyé au client, puis décodé et affiché.

Syntaxe

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

Paramètres

[in, out] pRenderHintID

Adresse d’une valeur qui identifie l’indicateur de rendu affecté par cet appel. Si un nouvel indicateur est créé, cette valeur doit contenir zéro. Cette fonction retourne un identificateur d’indicateur de rendu unique qui est utilisé pour les appels suivants, comme l’effacement de l’indicateur.

[in] hwndOwner

Handle de fenêtre lié à la durée de vie de l’indicateur de rendu. Cette fenêtre est utilisée dans les situations où une cible d’indicateur est supprimée sans que l’indicateur soit explicitement effacé.

[in] renderHintType

Spécifie le type d’indicateur représenté par cet appel.

RENDER_HINT_CLEAR (0)

L’indicateur précédent est effacé.

pHintData doit avoir la valeur NULL.

RENDER_HINT_VIDEO (1)

Indique la présence d’une vidéo de déplacement.

pHintData contient une structure RECT qui spécifie les coordonnées et la taille de la zone de rendu. Ces coordonnées prenant en charge les PPP par moniteur sont relatives aux coordonnées clientes de la fenêtre représentée par le paramètre hwndOwner .

Windows 8 et Windows Server 2012 : les coordonnées ne sont pas compatibles avec DPI avant Windows 8.1 et Windows Server 2012 R2.

RENDER_HINT_MAPPEDWINDOW (2)

Indique la présence d’un mappage de fenêtre.

Windows 8 et Windows Server 2012 : les coordonnées ne sont pas compatibles avec DPI avant Windows 8.1 et Windows Server 2012 R2.

[in] cbHintDataLength

Taille, en BYTEs, de la mémoire tampon pHintData .

[in] pHintData

Données supplémentaires pour l’indicateur.

Le format de ces données dépend de la valeur passée dans le paramètre renderHintType .

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	wtshintapi.h
Bibliothèque	WtsApi32.lib
DLL	WtsApi32.dll

Partager via