Device.Reset, méthode
Mise à jour : novembre 2007
Réinitialise les paramètres de présentation pour le périphérique actuel.
Espace de noms : Microsoft.WindowsMobile.DirectX.Direct3D
Assembly : Microsoft.WindowsMobile.DirectX (dans Microsoft.WindowsMobile.DirectX.dll)
Syntaxe
'Déclaration
Public Sub Reset ( _
presentationParameters As PresentParameters _
)
'Utilisation
Dim instance As Device
Dim presentationParameters As PresentParameters
instance.Reset(presentationParameters)
public void Reset(
PresentParameters presentationParameters
)
public:
void Reset(
PresentParameters^ presentationParameters
)
public function Reset(
presentationParameters : PresentParameters
)
Paramètres
presentationParameters
Type : Microsoft.WindowsMobile.DirectX.Direct3D.PresentParametersStructure PresentParameters qui décrit les nouveaux paramètres de présentation. Cette valeur ne peut pas être null.
Exceptions
| Exception | Condition |
|---|---|
| InvalidCallException | L'appel de méthode n'est pas valide. Par exemple, un paramètre peut contenir une valeur non valide. |
| DriverInternalErrorException | Erreur de pilote interne. Les applications doivent généralement s'arrêter lorsqu'elles reçoivent cette erreur. |
| OutOfMemoryException | Direct3D n'a pas pu allouer suffisamment de mémoire pour compléter l'appel. |
Notes
Lors du passage en mode plein écran, Direct3D essaie de rechercher un format de bureau qui correspond au format de mémoire tampon d'arrière-plan afin que les formats de tampon d'affichage et d'arrière-plan soient identiques. Cette opération élimine la nécessité de convertir les couleurs.
Si un appel à Reset échoue, le périphérique est placé dans l'état « perdu » indiqué par une valeur de retour de false à partir d'un appel à CheckCooperativeLevel, sauf s'il est déjà dans l'état « non réinitialisé » indiqué par DeviceNotReset retourné par le paramètre hResult de la méthode CheckCooperativeLevel.
L'appel à Reset entraîne la perte de toutes les surfaces de la mémoire de texture et des informations d'état, et l'effacement des textures managées de la mémoire vidéo. Avant d'appeler Reset pour un périphérique, une application doit libérer toutes les cibles de rendu explicites, les surfaces du stencil de profondeur, les chaînes de permutation supplémentaires, les blocs d'état et les ressources par défaut associées au périphérique.
Les chaînes de permutation sont plein écran ou avec fenêtres. Si la nouvelle chaîne de permutation est plein écran, la carte est placée dans le mode d'affichage qui correspond à la nouvelle taille.
Un appel à Reset échoue s'il a lieu sur un thread différent de celui utilisé pour créer le périphérique qui est réinitialisé.
Vous pouvez spécifier "inconnu" pour le format de la mémoire tampon d'arrière-plan du mode fenêtré lorsque vous appelez Device, Reset et SwapChain. Cela signifie que l'application ne doit pas interroger le format de bureau actuel avant d'appeler Device pour le mode fenêtré. Pour le mode plein écran, vous devez spécifier le format de la mémoire tampon d'arrière-plan. Affecter 0 à BackBufferCount crée une mémoire tampon d'arrière-plan.
Lorsque vous essayez de réinitialiser plusieurs cartes vidéo dans un groupe, passez dans un tableau d'objets PresentParameters, un pour chaque affichage dans le groupe de la carte.
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