Device.CheckCooperativeLevel, méthode (Int32%)

Article
09/04/2008

Mise à jour : novembre 2007

Indique l'état du niveau coopératif actuel du périphérique Direct3D pour une application avec fenêtres ou plein écran.

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

Syntaxe

'Déclaration
Public Function CheckCooperativeLevel ( _
    <OutAttribute> ByRef hResult As Integer _
) As Boolean
'Utilisation
Dim instance As Device
Dim hResult As Integer
Dim returnValue As Boolean

returnValue = instance.CheckCooperativeLevel(hResult)

public bool CheckCooperativeLevel(
    out int hResult
)

public:
bool CheckCooperativeLevel(
    [OutAttribute] int% hResult
)

public function CheckCooperativeLevel(
    hResult : int
) : boolean

Paramètres

hResult
Type : System.Int32%

L'état de niveau coopératif actuel du périphérique pour une application avec fenêtres ou plein écran, indique l'utilisation d'une valeur ResultCode. Un résultat Success indique que le périphérique est opérationnel et que l'application appelante peut continuer. Un résultat DeviceLost indique que le périphérique est perdu, mais ne peut pas être réinitialisé à temps ; par conséquent, le rendu n'est pas possible. Un résultat DeviceNotReset indique que le périphérique est perdu, mais peut être réinitialisé à temps.

Valeur de retour

Type : System.Boolean

true si le périphérique est opérationnel et l'application appelante peut continuer ; false si le périphérique est perdu ou doit être réinitialisé.

Notes

Si le périphérique est perdu, mais ne peut pas être restauré à l'heure du jour, CheckCooperativeLevel retourne le code de résultat DeviceLost dans le paramètre hResult C'est le cas par exemple, lorsqu'un périphérique de plein écran perd le focus. Si une application détecte un périphérique perdu, elle doit s'interrompre et appeler périodiquement CheckCooperativeLevel jusqu'à ce qu'elle reçoive une valeur de retour de DeviceNotReset. L'application peut essayer ensuite de réinitialiser le périphérique en appelant Reset et, si cela réussit, restaurer les ressources nécessaires et reprendre un fonctionnement normal. Notez que Present lève une DeviceLostException si le périphérique est perdu ou n'est pas réinitialisé.

Un appel à CheckCooperativeLevel échoue s'il a lieu sur un thread différent de celui utilisé pour créer le périphérique qui est réinitialisé.

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.