Метод IDCompositionVirtualSurface::Trim (dcomp.h)
Удаляет пиксели, которые находятся за пределами указанных прямоугольников обрезки.
Синтаксис
HRESULT Trim(
[in, optional] const RECT *rectangles,
[in] UINT count
);
Параметры
[in, optional] rectangles
Тип: const RECT*
Массив прямоугольников для сохранения.
[in] count
Тип: UINT
Число прямоугольников в массиве прямоугольников .
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .
Комментарии
Виртуальная поверхность может не иметь достаточно места для каждого пикселя в поверхности. Приложение предписывает обработчику композиции выделить память для поверхности путем вызова метода IDCompositionSurface::BeginDraw и освободить память для поверхности путем вызова метода IDCompositionVirtualSurface::Trim . Массив прямоугольников представляет области виртуальной поверхности, которые должны оставаться выделенными после возврата этого метода. Все пиксели, которые находятся за пределами указанного набора прямоугольников, больше не используются для форматирования, и их память может быть освобождена.
Если параметр count равен нулю, пиксели не сохраняются, и вся память, выделенная для виртуальной поверхности, может быть освобождена. Параметр rectangles может иметь значение NULL, только если параметр count равен нулю.
Этот метод завершается ошибкой, если метод IDCompositionSurface::BeginDraw был вызван для этого растрового изображения без соответствующего вызова IDCompositionSurface::EndDraw.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | dcomp.h |
| Библиотека | Dcomp.lib |
| DLL | Dcomp.dll |