Método IDCompositionDesktopDevice::CreateSurfaceFromHwnd (dcomp.h)
Crea un objeto contenedor que representa la rasterización de una ventana superpuesta y que se puede asociar a un objeto visual para la composición.
Sintaxis
HRESULT CreateSurfaceFromHwnd(
[in] HWND hwnd,
[out] IUnknown **surface
);
Parámetros
[in] hwnd
Identificador de la ventana superpuesta para la que se va a crear un contenedor. Se crea una ventana superpuesta especificando WS_EX_LAYERED al crear la ventana con la función CreateWindowEx o estableciendo WS_EX_LAYERED a través de SetWindowLong una vez creada la ventana.
[out] surface
Nuevo objeto de superficie 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
Puede usar el puntero de superficie en llamadas al método IDCompositionVisual::SetContent para establecer el contenido de uno o varios objetos visuales. Después de establecer el contenido, los objetos visuales componen el contenido de la ventana superpuesta especificada siempre que la ventana esté superpuesta. Si la ventana no está en capas, el contenido de la ventana desaparece de la salida del árbol de composición. Si la ventana se vuelve a superponer posteriormente, el contenido de la ventana vuelve a aparecer siempre y cuando todavía esté asociado a un objeto visual. Si se cambia el tamaño de la ventana, los objetos visuales afectados se vuelven a componer.
El contenido de la ventana no se almacena en caché más allá de la duración de la ventana. Es decir, si se destruye la ventana, los objetos visuales afectados dejan de componer la ventana.
Si la ventana se mueve fuera de la pantalla o cambia de tamaño a cero, el sistema deja de componer el contenido de esos objetos visuales. Debe usar la función DwmSetWindowAttribute con la marca DWMWA_CLOAK para "ocultar" la ventana secundaria superpuesta cuando necesite ocultar la ventana original y permitir que el sistema siga redactando el contenido de los objetos visuales.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | dcomp.h |