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 |