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

Descarta pixels que ficam fora dos retângulos de corte especificados.

Sintaxe

HRESULT Trim(
  [in, optional] const RECT *rectangles,
  [in]           UINT       count
);

Parâmetros

[in, optional] rectangles

Tipo: const RECT*

Uma matriz de retângulos a serem mantidos.

[in] count

Tipo: UINT

O número de retângulos na matriz de retângulos .

Retornar valor

Tipo: HRESULT

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 superfície virtual pode não ter armazenamento suficiente para cada pixel na superfície. Um aplicativo instrui o mecanismo de composição a alocar memória para a superfície chamando o método IDCompositionSurface::BeginDraw e liberar memória para a superfície chamando o método IDCompositionVirtualSurface::Trim . A matriz de retângulos representa as regiões da superfície virtual que devem permanecer alocadas após o retorno desse método. Todos os pixels que estão fora do conjunto especificado de retângulos não são mais usados para texturização e sua memória pode ser recuperada.

Se o parâmetro count for zero, nenhum pixel será mantido e toda a memória alocada para a superfície virtual poderá ser recuperada. O parâmetro retângulos só poderá ser NULL se o parâmetro count for zero.

Esse método falhará se IDCompositionSurface::BeginDraw tiver sido chamado para esse bitmap sem uma chamada correspondente para IDCompositionSurface::EndDraw.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dcomp.h
Biblioteca	Dcomp.lib
DLL	Dcomp.dll

Confira também

IDCompositionDevice::CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface::Resize