Device.SetRenderTarget, méthode

Article
09/04/2008

Mise à jour : novembre 2007

Définit une nouvelle mémoire tampon de couleur pour un périphérique.

Espace de noms : Microsoft.WindowsMobile.DirectX.Direct3D
Assembly : Microsoft.WindowsMobile.DirectX (dans Microsoft.WindowsMobile.DirectX.dll)

Syntaxe

'Déclaration
Public Sub SetRenderTarget ( _
    renderTarget As Surface, _
    newZStencil As Surface _
)
'Utilisation
Dim instance As Device
Dim renderTarget As Surface
Dim newZStencil As Surface

instance.SetRenderTarget(renderTarget, _
    newZStencil)

public void SetRenderTarget(
    Surface renderTarget,
    Surface newZStencil
)

public:
void SetRenderTarget(
    Surface^ renderTarget, 
    Surface^ newZStencil
)

public function SetRenderTarget(
    renderTarget : Surface, 
    newZStencil : Surface
)

Paramètres

renderTarget
Type : Microsoft.WindowsMobile.DirectX.Direct3D.Surface

Index Surface de la cible de rendu.

newZStencil
Type : Microsoft.WindowsMobile.DirectX.Direct3D.Surface

Une nouvelle mémoire tampon de couleur Surface. Si celle-ci a la valeur nullune référence null (Nothing en Visual Basic), la mémoire tampon de couleur du renderTarget correspondant est désactivée. Les périphériques doivent toujours être associés à une mémoire tampon de couleur.

La nouvelle surface cible de rendu doit avoir au moins Usage spécifié.

Exceptions

Exception	Condition
InvalidCallException	L'appel de méthode n'est pas valide. Soit renderTarget est null et newZStencil = 0, soit renderTarget n'est pas null et la cible de rendu n'est pas valide.

Notes

Le périphérique peut prendre en charge plusieurs cibles de rendu. Certains matériels testent la compatibilité du tampon de stencil de profondeur avec la mémoire tampon de couleur. Si cette opération est effectuée, elle se déroule uniquement dans une version debug. Les restrictions suivantes s'appliquent lors de l'utilisation de cette méthode :

Le type MultiSampleType doit être le même que la cible de rendu et la surface du stencil de profondeur.
Les formats doivent être compatibles pour la cible de rendu et de la surface du stencil de profondeur. Pour plus d'informations, consultez CheckDepthStencilMatch.
La taille de la surface du stencil de profondeur doit être supérieure ou égale à la taille de la cible du rendu.

Ces restrictions sont validées uniquement lors de l'utilisation de l'exécution du débogage lorsqu'une méthode de dessin Device est appelée.

Autorisations

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Plateformes

Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Compact Framework

Pris en charge dans : 3.5, 2.0

Voir aussi

Référence

Device, classe

Membres Device

Microsoft.WindowsMobile.DirectX.Direct3D, espace de noms

Partager via