Manager.CheckDeviceFormatConversion メソッド
[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]
デバイスをテストして、ある表示形式から別の表示形式への変換をサポートしているかどうかを判断します。
名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (Microsoft.WindowsMobile.DirectX.dll 内)
構文
'宣言
Public Shared Function CheckDeviceFormatConversion ( _
adapter As Integer, _
deviceType As DeviceType, _
sourceFormat As Format, _
destFormat As Format _
) As Boolean
'使用
Dim adapter As Integer
Dim deviceType As DeviceType
Dim sourceFormat As Format
Dim destFormat As Format
Dim returnValue As Boolean
returnValue = Manager.CheckDeviceFormatConversion(adapter, _
deviceType, sourceFormat, destFormat)
public static bool CheckDeviceFormatConversion(
int adapter,
DeviceType deviceType,
Format sourceFormat,
Format destFormat
)
public:
static bool CheckDeviceFormatConversion(
int adapter,
DeviceType deviceType,
Format sourceFormat,
Format destFormat
)
static member CheckDeviceFormatConversion :
adapter:int *
deviceType:DeviceType *
sourceFormat:Format *
destFormat:Format -> bool
パラメーター
- adapter
型 : System.Int32
照会するディスプレイ アダプターを示す序数。AdapterListCollection.Default は常に、プライマリ ディスプレイ アダプターです。
- deviceType
型 : Microsoft.WindowsMobile.DirectX.Direct3D.DeviceType
デバイスの種類を識別する DeviceType 列挙体のメンバー。
- sourceFormat
型 : Microsoft.WindowsMobile.DirectX.Direct3D.Format
元のアダプター形式を識別する Format 列挙体のメンバー。
- destFormat
型 : Microsoft.WindowsMobile.DirectX.Direct3D.Format
出力先のアダプター形式を識別する Format 列挙体のメンバー。
戻り値
型 : System.Boolean
メソッドが成功した場合は true。それ以外の場合は false。
解説
CheckDeviceType を使用して、バック バッファーと表示形式の間の互換性をテストすると、適切な値が返されます。つまり、呼び出しがデバイスの機能を反映していることを表します。そのデバイスにより、要求されたバック バッファー形式にレンダリングできない場合でも、呼び出しにより NotAvailable 列挙体の ResultCode が返されます。デバイスにより、その形式にレンダリングできても、カラーの変換表示が実行できない場合も、戻り値は NotAvailable になります。アプリケーションでは、CheckDeviceFormatConversion を呼び出すことにより、その表示自体のハードウェア サポートを確認できます。カラー変換表示自体のソフトウェア エミュレーションはありません。
Device.StretchRectangle を呼び出す場合に、CheckDeviceFormatConversion を使用して、元のサーフェイス形式と出力先のサーフェイス形式の組み合わせのいずれが許容されるかを判断することもできます。
カラー変換元の形式は、4 文字のコード (FOURCC) 形式、または有効なバック バッファー形式であることが必要です。出力先の形式は、次の符号なし形式のいずれかであることが必要です。
X1R5G5B5 |
X1R5G5B5 |
R5G6B5 |
R8G8B8 |
R8G8B8 |
A8R8G8B8 |
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分的に信頼される側のコードからライブラリの使用」を参照してください。
プラットフォーム
Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET フレームワークのシステム要件」を参照してください。
バージョン情報
.NET Compact Framework
サポート対象 : 3.5、2.0