Share via

Método IDCompositionVirtualSurface::Trim (dcomp.h)

  • Artículo

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

Consulte también

IDCompositionDevice::CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface::Resize