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 |