Método IDCompositionVirtualSurface::Trim (dcomp.h)
Descarta los píxeles que se encuentran fuera de los rectángulos de recorte especificados.
Sintaxis
HRESULT Trim(
[in, optional] const RECT *rectangles,
[in] UINT count
);
Parámetros
[in, optional] rectangles
Tipo: const RECT*
Matriz de rectángulos que se van a conservar.
[in] count
Tipo: UINT
Número de rectángulos de la matriz de rectángulos .
Valor devuelto
Tipo: HRESULT
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
Es posible que una superficie virtual no tenga suficiente almacenamiento para cada píxel de la superficie. Una aplicación indica al motor de composición que asigne memoria para la superficie mediante una llamada al método IDCompositionSurface::BeginDraw y que libere memoria para la superficie llamando al método IDCompositionVirtualSurface::Trim . La matriz de rectángulos representa las regiones de la superficie virtual que deben permanecer asignadas después de que este método devuelva. Los píxeles que están fuera del conjunto especificado de rectángulos ya no se usan para la texturización y se puede reclamar su memoria.
Si el parámetro count es cero, no se conservan píxeles y se puede reclamar toda la memoria asignada para la superficie virtual. El parámetro rectángulos solo puede ser NULL si el parámetro count es cero.
Este método produce un error si se llamó a IDCompositionSurface::BeginDraw para este mapa de bits sin una llamada correspondiente a IDCompositionSurface::EndDraw.
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 |