Metodo IDCompositionVirtualSurface::Trim (dcomp.h)

Rimuove i pixel che rientrano all'esterno dei rettangoli di taglio specificati.

Sintassi

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

Parametri

[in, optional] rectangles

Tipo: const RECT*

Matrice di rettangoli da mantenere.

[in] count

Tipo: UINT

Numero di rettangoli nella matrice rettangoli .

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore DirectComposition .

Commenti

Una superficie virtuale potrebbe non avere spazio di archiviazione sufficiente per ogni pixel nella superficie. Un'applicazione indica al motore di composizione di allocare memoria per la superficie chiamando il metodo IDCompositionSurface::BeginDraw e rilasciando memoria per la superficie chiamando il metodo IDCompositionVirtualSurface::Trim . La matrice di rettangoli rappresenta le aree della superficie virtuale che deve rimanere allocata dopo che questo metodo restituisce. Tutti i pixel esterni al set specificato di rettangoli non vengono più usati per la texturing e la memoria può essere recuperata.

Se il parametro di conteggio è zero, non vengono mantenuti pixel e tutti i pixel allocati per la superficie virtuale possono essere recuperati. Il parametro rettangoli può essere NULL solo se il parametro count è zero.

Questo metodo ha esito negativo se IDCompositionSurface::BeginDraw è stato chiamato per questa bitmap senza una chiamata corrispondente a IDCompositionSurface::EndDraw.

Requisiti

Vedi anche

IDCompositionDevice::CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface::Resize