Freigeben über


WTSSetRenderHint-Funktion (wtshintapi.h)

Wird von einer Anwendung verwendet, die Inhalte anzeigt, die für die Anzeige in einer Remotesitzung optimiert werden können, um den Bereich eines Fensters zu identifizieren, bei dem es sich um den tatsächlichen Inhalt handelt.

In der Remotesitzung wird dieser Inhalt codiert, an den Client gesendet, dann decodiert und angezeigt.

Syntax

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

Parameter

[in, out] pRenderHintID

Die Adresse eines Werts, der den von diesem Aufruf betroffenen Renderinghinweis identifiziert. Wenn ein neuer Hinweis erstellt wird, muss dieser Wert null enthalten. Diese Funktion gibt einen eindeutigen Renderinghinweisbezeichner zurück, der für nachfolgende Aufrufe verwendet wird, z. B. das Löschen des Hinweises.

[in] hwndOwner

Das Handle des Fensters, das mit der Lebensdauer des Renderinghinweises verknüpft ist. Dieses Fenster wird in Situationen verwendet, in denen ein Hinweisziel entfernt wird, ohne dass der Hinweis explizit gelöscht wird.

[in] renderHintType

Gibt den Typ des Hinweises an, der durch diesen Aufruf dargestellt wird.

RENDER_HINT_CLEAR (0)

Der vorherige Hinweis wird gelöscht.

pHintData muss NULL sein.

RENDER_HINT_VIDEO (1)

Gibt das Vorhandensein von bewegten Videos an.

pHintData enthält eine RECT-Struktur , die die Koordinaten und die Größe des Renderingbereichs angibt. Diese dpi-fähigen Koordinaten pro Monitor sind relativ zu den Clientkoordinaten des Fensters, das durch den hwndOwner-Parameter dargestellt wird.

Windows 8 und Windows Server 2012: Die Koordinaten sind vor Windows 8.1 und Windows Server 2012 R2 nicht DPI-fähig.

RENDER_HINT_MAPPEDWINDOW (2)

Gibt das Vorhandensein einer Fensterzuordnung an.

pHintData enthält eine RECT-Struktur , die die Koordinaten und die Größe des Renderingbereichs angibt. Diese dpi-fähigen Koordinaten pro Monitor sind relativ zu den Clientkoordinaten des Fensters, das durch den hwndOwner-Parameter dargestellt wird.

Windows 8 und Windows Server 2012: Die Koordinaten sind vor Windows 8.1 und Windows Server 2012 R2 nicht DPI-fähig.

[in] cbHintDataLength

Die Größe des pHintData-Puffers in BYTEs.

[in] pHintData

Zusätzliche Daten für den Hinweis.

Das Format dieser Daten hängt vom Wert ab, der im renderHintType-Parameter übergeben wird.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile wtshintapi.h
Bibliothek WtsApi32.lib
DLL WtsApi32.dll