Manager.CheckDeviceType-Methode
Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]
Gibt an, ob ein Gerät hardwarebeschleunigten auf dem aktuellen Adapter verwendet werden kann.
Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)
Syntax
'Declaration
Public Shared Function CheckDeviceType ( _
adapter As Integer, _
checkType As DeviceType, _
displayFormat As Format, _
backBufferFormat As Format, _
windowed As Boolean _
) As Boolean
'Usage
Dim adapter As Integer
Dim checkType As DeviceType
Dim displayFormat As Format
Dim backBufferFormat As Format
Dim windowed As Boolean
Dim returnValue As Boolean
returnValue = Manager.CheckDeviceType(adapter, _
checkType, displayFormat, backBufferFormat, _
windowed)
public static bool CheckDeviceType(
int adapter,
DeviceType checkType,
Format displayFormat,
Format backBufferFormat,
bool windowed
)
public:
static bool CheckDeviceType(
int adapter,
DeviceType checkType,
Format displayFormat,
Format backBufferFormat,
bool windowed
)
static member CheckDeviceType :
adapter:int *
checkType:DeviceType *
displayFormat:Format *
backBufferFormat:Format *
windowed:bool -> bool
Parameter
- adapter
Typ: System.Int32
Ordinalzahl, die den Anzeigeadapter auf Abfrage.AdapterListCollection.Default ist immer die primäre Grafikkarte.
- checkType
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.DeviceType
Member der DeviceType-Enumeration, die den Gerätetyp identifiziert.
- displayFormat
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Format
Member der Format-Enumeration, der das Format des Anzeigemodus Adapter angibt, für den der Gerätetyp überprüft wird.Beispielsweise werden einige Geräte nur in Betriebsmodi 16 Bits pro Pixel betrieben.
- backBufferFormat
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.Format
Format des Hintergrundpuffers.Weitere Informationen über Formate finden Sie unter Format.Dieser Wert muss eines der Formate rendern Ziel sein.Eigenschaft die ein DisplayModeDevice kann mit dem das aktuelle Format abgerufen werden.Bei Anwendungen im Fenstermodus muss das Format des Hintergrundpuffers nicht das Anzeigeformat Modus übereinstimmen, wenn die Hardware die Farbkonvertierung unterstützt.Satz der möglichen Hintergrundpuffer Formate ist eingeschränkt, aber die Common Language Runtime ermöglicht gültige Hintergrundpufferformat zu jedem desktop Format dargestellt werden.Darüber hinaus muss das Gerät im Desktopmodus betriebsfähig sein, da Geräte i. d. r. nicht im Modus von 8 Bits pro Pixel betrieben werden.
Vollbild-Anwendungen können keine Farbkonvertierung ausführen.Sie können UnknownFormat für den Windows-Modus angeben.
- windowed
Typ: System.Boolean
Legen Sie true, um Multisampling im Fenstermodus abzufragen.Legen Sie false, um Multisampling Vollbildmodus abzufragen.
Rückgabewert
Typ: System.Boolean
true , wenn die Methode erfolgreich ausgeführt wird und das Gerät können auf diesem Adapter; verwendet werdenandernfalls false.
Hinweise
Ein Hardware Abstraktionsschicht (Layer, HAL) Gerät erfordert Hardwarebeschleunigung.Anwendungen, die die CheckDeviceType-Methode verwenden können, um eine HAL-Gerät unterstützen, sind vorhanden.
Vollbild-Anwendungen sollten kein displayFormat angeben, die einen Alphakanal; enthältDies führt so einen fehlgeschlagenen Aufruf.Beachten Sie, dass ein Alphakanal kann in den Hintergrundpuffer vorhanden sein, aber zwei Anzeigeformate müssen in allen anderen Hinsicht identisch sein.Beispielsweise wenn displayFormatX1R5G5B5, gültige Werte für backBufferFormatX1R5G5B5 und A1R5G5B5 enthalten jedoch ausschließen R5G6B5 =.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, ob auf dem Adapter ein bestimmter Gerätetyp verwendet werden kann.
PublicSub CheckDeviceType()
' Test some formats
IsDeviceTypeOK(Format.X8R8G8B8, Format.A8R8G8B8)
If result <> Fix(ResultCode.Success) Then
System.Windows.Forms.MessageBox.Show(String.Format("The device check failed: {0}", result))
EndIfEndSubPublicFunction IsDeviceTypeOK(ByVal displayFmt As Format, ByVal backbufferFmt As Format) AsBooleanDim ai As AdapterInformation = Microsoft.WindowsMobile.DirectX.Direct3D.Manager.Adapters.Default
' Verify that the device can be used on the default adapter with the given surface formatIf Microsoft.WindowsMobile.DirectX.Direct3D.Manager.CheckDeviceType(ai.Adapter, DeviceType.Default, displayFmt, backbufferFmt, False) ThenReturnTrue ' if the call succeeds
EndIfReturnFalse ' otherwise fail. NOTE: HRESULT passed back in resultEndFunction
publicvoid CheckDeviceType()
{
// Test some formats
IsDeviceTypeOK(Format.X8R8G8B8, Format.A8R8G8B8);
if (result != (int)ResultCode.Success)
System.Windows.Forms.MessageBox.Show(String.Format("The device check failed: {0}", result));
}
publicbool IsDeviceTypeOK(Format displayFmt, Format backbufferFmt)
{
AdapterInformation ai = Microsoft.WindowsMobile.DirectX.Direct3D.Manager.Adapters.Default;
// Verify that the device can be used on the default adapter with the given surface formatif (Microsoft.WindowsMobile.DirectX.Direct3D.Manager.CheckDeviceType(ai.Adapter, DeviceType.Default, displayFmt, backbufferFmt, false))
{
returntrue; // if the call succeeds
}
returnfalse; // otherwise fail. NOTE: HRESULT passed back in result
}
.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.
Versionsinformationen
.NET Compact Framework
Unterstützt in: 3.5, 2.0