Device.CheckCooperativeLevel-Methode (Int32%)

Artikel
11/08/2009

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Meldet den aktuellen Status kooperativen Ebene des Direct3D-Geräts für eine Anwendung im Fenstermodus oder von Vollbild.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Function CheckCooperativeLevel ( _
    <OutAttribute> ByRef hResult As Integer _
) As Boolean
'Usage
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
)

member CheckCooperativeLevel : 
        hResult:int byref -> bool

Parameter

hResult
Typ: System.Int32%
Der aktuelle kooperativen Ebene Status des Geräts für eine Anwendung im Fenstermodus oder von Vollbild angezeigt, mit einem Wert ResultCode.Zeigt ein Success Ergebnis an, dass das Gerät betriebsbereit ist und dass die aufrufende Anwendung fortfahren kann.Ein DeviceLost--Ergebnis gibt an, dass das Gerät verloren geht, aber kann nicht zu diesem Zeitpunkt; zurückgesetzt werdenRendering ist daher nicht möglich.DeviceNotReset Ergebnis bedeutet, dass das Gerät verloren geht, aber zu diesem Zeitpunkt zurückgesetzt werden kann.

Rückgabewert

Typ: System.Boolean
true , wenn das Gerät betriebsbereit ist und die aufrufende Anwendung kann; fortgesetzt werdenfalse Wenn das Gerät verloren geht oder zurückgesetzt werden muss.

Hinweise

Wenn das Gerät verloren geht, aber nicht zum aktuellen Zeitpunkt wiederhergestellt werden kann, gibt CheckCooperativeLevel DeviceLost -Ergebniscode in der hResult Parameter zurück.Dies ist der Fall, z. B. Wenn ein Vollbild-Gerät den Fokus verliert.Wenn eine Anwendung ein verlorenes Gerät erkennt, sollten Sie anhalten und CheckCooperativeLevel in regelmäßigen Abständen aufrufen, bis er einen Rückgabewert von DeviceNotReset empfängt.Die Anwendung kann dann versuchen, Zurücksetzen des Geräts durch Aufrufen von Reset und, wenn dies gelingt, die erforderlichen Ressourcen wiederherstellen und normalen Betrieb fortsetzen.Beachten Sie, Present ein DeviceLostException auslöst, wenn das Gerät ist verloren gegangen oder nicht zurückgesetzt.

Schlägt ein Aufruf zu CheckCooperativeLevel fehl, wenn auf einem anderen Thread als dem verwendet, um das Gerät zurückgesetzt zu erstellen.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Plattformen

Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC

Die .NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET framework.