Método IDCompositionDesktopDevice::CreateTargetForHwnd (dcomp.h)

Crea un objeto de destino de composición enlazado a la ventana representada por el identificador de ventana especificado.

Sintaxis

HRESULT CreateTargetForHwnd(
  [in]  HWND                hwnd,
        BOOL                topmost,
  [out] IDCompositionTarget **target
);

Parámetros

[in] hwnd

Ventana a la que se debe enlazar el objeto de destino de composición. Este parámetro no debe ser null.

topmost

TRUE si el árbol visual debe mostrarse encima de los elementos secundarios de la ventana especificada por el parámetro hwnd; de lo contrario, el árbol visual se muestra detrás de los elementos secundarios.

[out] target

Nuevo objeto de destino de composición. Este parámetro no debe ser null.

Valor devuelto

Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT. Consulte Códigos de error de DirectComposition para obtener una lista de códigos de error.

Comentarios

Un árbol visual DirectComposition debe enlazarse a una ventana antes de que se pueda mostrar algo en la pantalla. La ventana puede ser una ventana de nivel superior o una ventana secundaria. En cualquier caso, la ventana puede ser una ventana superpuesta, pero en todos los casos la ventana debe pertenecer al proceso de llamada. Si la ventana pertenece a un proceso diferente, este método devuelve DCOMPOSITION_ERROR_ACCESS_DENIED.

Cuando el contenido de DirectComposition se compone en la ventana, el contenido siempre se compone sobre lo que se dibuja directamente en esa ventana a través del contexto del dispositivo devuelto por la función GetDC o por llamadas a los métodos DirectX Present. Sin embargo, dado que las reglas de recorte de ventanas se aplican al contenido de DirectComposition, si la ventana tiene ventanas secundarias, esas ventanas secundarias pueden recortar el árbol visual. El parámetro superior determina si las ventanas secundarias recortan el árbol visual.

Conceptualmente, cada ventana consta de cuatro capas:

1. El contenido dibujado directamente en el identificador de ventana (esta es la capa más baja).
2. Un árbol visual DirectComposition opcional.
3. El contenido de todas las ventanas secundarias, si existe.
4. Otro árbol visual DirectComposition opcional (es la capa superior).

Las cuatro capas se recortan en la región visible de la ventana.

Como máximo, solo se pueden crear dos destinos de composición para cada ventana del sistema, una más alta y otra no superior. Si un destino de composición ya está enlazado a la ventana especificada en la capa especificada, se produce un error en este método. Cuando se destruye un objeto de destino de composición, la capa compuesta está disponible para su uso por un nuevo objeto de destino de composición.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	dcomp.h

Consulte también

IDCompositionDesktopDevice

IDCompositionVisual2