Función WTSSetRenderHint (wtshintapi.h)

Se usa en una aplicación que muestra contenido que se puede optimizar para mostrar en una sesión remota para identificar la región de una ventana que es el contenido real.

En la sesión remota, este contenido se codificará, se enviará al cliente y, a continuación, se descodificará y mostrará.

Sintaxis

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

Parámetros

[in, out] pRenderHintID

Dirección de un valor que identifica la sugerencia de representación afectada por esta llamada. Si se crea una nueva sugerencia, este valor debe contener cero. Esta función devolverá un identificador de sugerencia de representación único que se usa para las llamadas posteriores, como borrar la sugerencia.

[in] hwndOwner

Identificador de la ventana vinculada a la duración de la sugerencia de representación. Esta ventana se usa en situaciones en las que se quita un destino de sugerencia sin que se borre explícitamente la sugerencia.

[in] renderHintType

Especifica el tipo de sugerencia representada por esta llamada.

RENDER_HINT_CLEAR (0)

Se borra la sugerencia anterior.

pHintData debe ser NULL.

RENDER_HINT_VIDEO (1)

Indica la presencia de vídeo en movimiento.

pHintData contiene una estructura RECT que especifica las coordenadas y el tamaño del área de representación. Estas coordenadas compatibles con PPP por monitor son relativas a las coordenadas de cliente de la ventana representadas por el parámetro hwndOwner .

Windows 8 y Windows Server 2012: las coordenadas no son compatibles con PPP antes de Windows 8.1 y Windows Server 2012 R2.

RENDER_HINT_MAPPEDWINDOW (2)

Indica la presencia de una asignación de ventana.

pHintData contiene una estructura RECT que especifica las coordenadas y el tamaño del área de representación. Estas coordenadas compatibles con PPP por monitor son relativas a las coordenadas de cliente de la ventana representadas por el parámetro hwndOwner .

Windows 8 y Windows Server 2012: las coordenadas no son compatibles con PPP antes de Windows 8.1 y Windows Server 2012 R2.

[in] cbHintDataLength

Tamaño, en BYTES, del búfer pHintData .

[in] pHintData

Datos adicionales para la sugerencia.

El formato de estos datos depende del valor pasado en el parámetro renderHintType .

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	wtshintapi.h
Library	WtsApi32.lib
Archivo DLL	WtsApi32.dll