IDCompositionVirtualSurface::Trim-Methode (dcomp.h)

Verwirft Pixel, die außerhalb der angegebenen Kürzungsrechtecke liegen.

Syntax

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

Parameter

[in, optional] rectangles

Typ: const RECT*

Ein Array von Rechtecken, die beibehalten werden sollen.

[in] count

Typ: UINT

Die Anzahl der Rechtecke im Rechteckarray .

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Eine virtuelle Oberfläche verfügt möglicherweise nicht über genügend Speicherplatz für jedes Pixel in der Oberfläche. Eine Anwendung weist die Kompositions-Engine an, Arbeitsspeicher für die Oberfläche zuzuweisen, indem sie die IDCompositionSurface::BeginDraw-Methode aufruft , und arbeitsspeicher für das Surface durch Aufrufen der IDCompositionVirtualSurface::Trim-Methode freizugeben. Das Array von Rechtecken stellt die Bereiche der virtuellen Oberfläche dar, die nach der Rückgabe dieser Methode zugeordnet bleiben sollen. Alle Pixel, die sich außerhalb der angegebenen Gruppe von Rechtecken befinden, werden nicht mehr für die Texturierung verwendet, und ihr Arbeitsspeicher kann wieder beansprucht werden.

Wenn der Count-Parameter null ist, werden keine Pixel beibehalten, und der gesamte für die virtuelle Oberfläche zugeordnete Arbeitsspeicher kann wieder beansprucht werden. Der Parameter rectangles kann nur NULL sein, wenn der count-Parameter null ist.

Diese Methode schlägt fehl, wenn IDCompositionSurface::BeginDraw für diese Bitmap ohne einen entsprechenden Aufruf von IDCompositionSurface::EndDraw aufgerufen wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dcomp.h
Bibliothek	Dcomp.lib
DLL	Dcomp.dll

Weitere Informationen

IDCompositionDevice::CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface::Resize