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

Cria um objeto de destino de composição associado à janela representada pelo identificador de janela especificado.

Sintaxe

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

Parâmetros

[in] hwnd

A janela à qual o objeto de destino de composição deve ser associado. Esse parâmetro não deve ser NULL.

topmost

TRUE se a árvore visual deve ser exibida sobre os filhos da janela especificada pelo parâmetro hwnd; caso contrário, a árvore visual é exibida atrás dos filhos.

[out] target

O novo objeto de destino de composição. Esse parâmetro não deve ser NULL.

Retornar valor

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Confira Códigos de erro do DirectComposition para obter uma lista de códigos de erro.

Comentários

Uma árvore visual DirectComposition deve ser associada a uma janela antes que qualquer coisa possa ser exibida na tela. A janela pode ser uma janela de nível superior ou uma janela filho. Em ambos os casos, a janela pode ser uma janela em camadas, mas em todos os casos a janela deve pertencer ao processo de chamada. Se a janela pertencer a um processo diferente, esse método retornará DCOMPOSITION_ERROR_ACCESS_DENIED.

Quando o conteúdo do DirectComposition é composto para a janela, o conteúdo é sempre composto sobre o que é desenhado diretamente para essa janela por meio do contexto do dispositivo retornado pela função GetDC ou por chamadas aos métodos DirectX Present. No entanto, como as regras de recorte de janela se aplicam ao conteúdo do DirectComposition, se a janela tiver janelas filho, essas janelas filho poderão recortar a árvore visual. O parâmetro mais alto determina se as janelas filho recortarão a árvore visual.

Conceitualmente, cada janela consiste em quatro camadas:

1. O conteúdo desenhado diretamente para o identificador de janela (essa é a camada mais inferior).
2. Uma árvore visual opcional do DirectComposition.
3. O conteúdo de todas as janelas filho, se houver.
4. Outra árvore visual opcional do DirectComposition (esta é a camada mais alta).

No máximo, apenas dois destinos de composição podem ser criados para cada janela no sistema, um mais alto e outro não superior. Se um destino de composição já estiver associado à janela especificada na camada especificada, esse método falhará. Quando um objeto de destino de composição é destruído, a camada composta por ele está disponível para uso por um novo objeto de destino de composição.

Requisitos

Confira também

IDCompositionDesktopDevice

IDCompositionVisual2