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
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | dcomp.h |
Bibliothèque | Dcomp.lib |
DLL | Dcomp.dll |