IDCompositionVirtualSurface ::Trim, méthode (dcomp.h)

Ignore les pixels qui se trouvent en dehors des rectangles de découpage spécifiés.

Syntaxe

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

Paramètres

[in, optional] rectangles

Type : const RECT*

Tableau de rectangles à conserver.

[in] count

Type : UINT

Nombre de rectangles dans le tableau de rectangles .

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur DirectComposition .

Remarques

Une surface virtuelle peut ne pas avoir suffisamment de stockage pour chaque pixel de la surface. Une application demande au moteur de composition d’allouer de la mémoire pour la surface en appelant la méthode IDCompositionSurface ::BeginDraw et de libérer de la mémoire pour la surface en appelant la méthode IDCompositionVirtualSurface ::Trim . Le tableau de rectangles représente les régions de la surface virtuelle qui doivent rester allouées après le retour de cette méthode. Tous les pixels qui se trouvent en dehors de l’ensemble de rectangles spécifié ne sont plus utilisés pour la texturation et leur mémoire peut être récupérée.

Si le paramètre count est égal à zéro, aucun pixel n’est conservé et toute la mémoire allouée pour la surface virtuelle peut être récupérée. Le paramètre rectangles ne peut être NULL que si le paramètre count est égal à zéro.

Cette méthode échoue si IDCompositionSurface ::BeginDraw a été appelé pour cette bitmap sans appel correspondant à IDCompositionSurface ::EndDraw.

Configuration requise

Voir aussi

IDCompositionDevice ::CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface ::Resize