Método IDCompositionVisual::SetContent (dcomp.h)
Establece la propiedad Content de este objeto visual en el contenedor de ventanas o mapa de bits especificado.
Sintaxis
HRESULT SetContent(
[in, optional] IUnknown *content
);
Parámetros
[in, optional] content
Tipo: IUnknown*
Objeto que es el nuevo contenido de este objeto visual. Este parámetro puede ser NULL.
Valor devuelto
Tipo: HRESULT
Si la función se ejecuta 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
El parámetro content debe apuntar a una de las siguientes opciones:
- Objeto que implementa la interfaz IDCompositionSurface .
- Objeto que implementa la interfaz IDXGISwapChain1 .
- Objeto contenedor devuelto por el método CreateSurfaceFromHandle o CreateSurfaceFromHwnd .
Un objeto visual se puede asociar a un objeto de mapa de bits o a un contenedor de ventanas. Un mapa de bits es una cadena de intercambio de Microsoft DirectX o una superficie de Microsoft DirectComposition.
Se crea un contenedor de ventanas con el método CreateSurfaceFromHwnd y es un elemento independiente para la rasterización de otra ventana, que debe ser una ventana de nivel superior o una ventana secundaria superpuesta. Un contenedor de ventanas es conceptualmente equivalente a un mapa de bits que es el tamaño de la ventana de destino en la que se dibuja el contenido de la ventana. El contenido incluye las ventanas secundarias de la ventana de destino (superpuestas o de otro modo) y cualquier contenido de DirectComposition dibujado en las ventanas secundarias.
Se crea un contenedor de superficie DirectComposition con el método CreateSurfaceFromHandle y es una referencia a una cadena de intercambio. Una aplicación puede usar un contenedor de superficie en un escenario entre procesos en el que un proceso crea la cadena de intercambio y otro proceso asocia el mapa de bits a un objeto visual.
El mapa de bits siempre se dibuja en la posición (0,0) en relación con el sistema de coordenadas del objeto visual, aunque el sistema de coordenadas se ve afectado directamente por las propiedades OffsetX, OffsetY y Transform, así como indirectamente por las transformaciones en los objetos visuales antecesor. El mapa de bits de un objeto visual siempre se dibuja detrás de los elementos secundarios de ese objeto visual.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | dcomp.h |
| Library | Dcomp.lib |
| Archivo DLL | Dcomp.dll |
Consulte también
IDXGIFactory2::CreateSwapChain1