Device, constructeur (Int32, DeviceType, IntPtr, CreateFlags, PresentParameters)

Article
09/04/2008

Mise à jour : novembre 2007

Initialise une nouvelle instance de la structure Device.

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

Syntaxe

'Déclaration
Public Sub New ( _
    adapter As Integer, _
    deviceType As DeviceType, _
    renderWindowHandle As IntPtr, _
    behaviorFlags As CreateFlags, _
    presentationParameters As PresentParameters _
)
'Utilisation
Dim adapter As Integer
Dim deviceType As DeviceType
Dim renderWindowHandle As IntPtr
Dim behaviorFlags As CreateFlags
Dim presentationParameters As PresentParameters

Dim instance As New Device(adapter, _
    deviceType, renderWindowHandle, _
    behaviorFlags, presentationParameters)

public Device(
    int adapter,
    DeviceType deviceType,
    IntPtr renderWindowHandle,
    CreateFlags behaviorFlags,
    PresentParameters presentationParameters
)

public:
Device(
    int adapter, 
    DeviceType deviceType, 
    IntPtr renderWindowHandle, 
    CreateFlags behaviorFlags, 
    PresentParameters^ presentationParameters
)

public function Device(
    adapter : int, 
    deviceType : DeviceType, 
    renderWindowHandle : IntPtr, 
    behaviorFlags : CreateFlags, 
    presentationParameters : PresentParameters
)

Paramètres

adapter
Type : System.Int32

Un nombre ordinal qui identifie quel périphérique physique l'objet représente. Le périphérique 0 est le périphérique par défaut. La valeur la plus élevée qui peut être utilisée dans ce paramètre est inférieure d'une valeur au nombre total des périphériques physiques.

deviceType
Type : Microsoft.WindowsMobile.DirectX.Direct3D.DeviceType

Membre du type DeviceType énuméré qui dénote le type de périphérique souhaité. Si le type de périphérique souhaité n'est pas disponible, la méthode échoue.

renderWindowHandle
Type : System.IntPtr

Un pointeur vers un formulaire non managé ou non Windows, handle de fenêtre. La fenêtre spécifiée doit être une fenêtre de niveau supérieur. Les valeurs Null ne sont pas prises en charge.

behaviorFlags
Type : Microsoft.WindowsMobile.DirectX.Direct3D.CreateFlags

Combinaison d'une ou plusieurs options qui contrôle la création de périphériques.

presentationParameters
Type : Microsoft.WindowsMobile.DirectX.Direct3D.PresentParameters

Objet PresentParameters qui décrit les paramètres de présentation du périphérique à créer.

Notes

Ce constructeur crée un objet périphérique entièrement fonctionnel qui est affecté du mode d'affichage requis (ou mode fenêtré) et auquel sont allouées les mémoires tampons d'arrière-plan appropriées. Pour commencer le rendu, l'application doit simplement créer et définir un tampon de profondeur.

Les mémoires tampons d'arrière-plan créées dans le cadre du périphérique sont verrouillables uniquement si LockableBackBuffer est spécifié dans PresentParameters. Les mémoires tampons d'arrière-plan d'échantillonnage multiple et les surfaces de profondeur ne sont jamais verrouillables.

Les méthodes Reset et TestCooperativeLevel doivent être appelées à partir du même thread qui a utilisé cette méthode pour créer un périphérique.

Le type Unknown peut être spécifié pour le format de la mémoire tampon d'arrière-plan en mode fenêtré lors de l'appel à Device, Reset et SwapChain (la substitution du constructeur pour créer une nouvelle chaîne de permutation). Cela signifie que l'application ne doit pas interroger le format de bureau actuel avant d'appeler le périphérique pour le mode fenêtré. Pour le mode plein écran, le format de la mémoire tampon d'arrière-plan doit être spécifié.

La méthode Device échoue en cas de tentative de création d'un périphérique sur une fenêtre de dimension 0x0.

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.