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 |