Funzione WTSSetRenderHint (wtshintapi.h)

Articolo
08/28/2023

Usato da un'applicazione che visualizza contenuto che può essere ottimizzato per la visualizzazione in una sessione remota per identificare l'area di una finestra che rappresenta il contenuto effettivo.

Nella sessione remota questo contenuto verrà codificato, inviato al client, quindi decodificato e visualizzato.

Sintassi

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

Parametri

[in, out] pRenderHintID

Indirizzo di un valore che identifica l'hint di rendering interessato da questa chiamata. Se viene creato un nuovo hint, questo valore deve contenere zero. Questa funzione restituirà un identificatore univoco dell'hint per il rendering usato per le chiamate successive, ad esempio la cancellazione dell'hint.

[in] hwndOwner

Handle di finestra collegato alla durata dell'hint per il rendering. Questa finestra viene usata nelle situazioni in cui una destinazione dell'hint viene rimossa senza che l'hint venga cancellato in modo esplicito.

[in] renderHintType

Specifica il tipo di hint rappresentato da questa chiamata.

RENDER_HINT_CLEAR (0)

L'hint precedente viene cancellato.

pHintData deve essere NULL.

RENDER_HINT_VIDEO (1)

Indica la presenza di video in movimento.

pHintData contiene una struttura RECT che specifica le coordinate e le dimensioni dell'area di rendering. Queste coordinate con riconoscimento DPI per monitor sono relative alle coordinate client della finestra rappresentata dal parametro hwndOwner .

Windows 8 e Windows Server 2012: le coordinate non sono compatibili con DPI prima di Windows 8.1 e Windows Server 2012 R2.

RENDER_HINT_MAPPEDWINDOW (2)

Indica la presenza di un mapping di finestra.

Windows 8 e Windows Server 2012: le coordinate non sono compatibili con DPI prima di Windows 8.1 e Windows Server 2012 R2.

[in] cbHintDataLength

Dimensione, in BYTEs, del buffer pHintData .

[in] pHintData

Dati aggiuntivi per l'hint.

Il formato di questi dati dipende dal valore passato nel parametro renderHintType .

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	wtshintapi.h
Libreria	WtsApi32.lib
DLL	WtsApi32.dll

Condividi tramite