Device.Reset メソッド

  • [アーティクル]

[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]

現在のデバイスのプレゼンテーション パラメーターをリセットします。

名前空間:  Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ:  Microsoft.WindowsMobile.DirectX (Microsoft.WindowsMobile.DirectX.dll 内)

構文

'宣言
Public Sub Reset ( _
    presentationParameters As PresentParameters _
)
'使用
Dim instance As Device
Dim presentationParameters As PresentParameters

instance.Reset(presentationParameters)

public void Reset(
    PresentParameters presentationParameters
)

public:
void Reset(
    PresentParameters^ presentationParameters
)

member Reset : 
        presentationParameters:PresentParameters -> unit

パラメーター

例外

例外 条件
InvalidCallException

メソッドの呼び出しが無効です。たとえば、パラメーターに無効な値が含まれている場合などです。
DriverInternalErrorException

ドライバーの内部エラー。このエラーを受け取った場合、通常、アプリケーションをシャットダウンする必要があります。
OutOfMemoryException

Direct3D で、呼び出しを完了するために十分なメモリを割り当てられませんでした。

解説

全画面表示モードに切り替えるときに、Direct3D は、バック バッファー形式とフロント バッファー形式を同一にするために、バック バッファー形式と合致するデスクトップ形式を探します。これにより、色変換の必要がなくなります。

Reset の呼び出しが失敗した場合、デバイスは (CheckCooperativeLevel の呼び出しからの戻り値 false で示される) "消失" 状態になります。ただし、デバイスが既に (DeviceNotReset メソッドの hResult パラメーターの戻り値 CheckCooperativeLevel で示される) "非リセット" 状態になっている場合は除きます。

Reset を呼び出すと、すべてのテクスチャ メモリ サーフェイスと状態情報が失われ、マネージ テクスチャがビデオ メモリからフラッシュされます。デバイスに対して Reset を呼び出す前に、アプリケーションは、デバイスに関連付けられているすべての明示的なレンダリング先、深度ステンシル サーフェイス、追加のスワップ チェーン、状態ブロック、および既定のリソースを解放する必要があります。

スワップ チェーンには、全画面表示スワップ チェーンとウィンドウ スワップ チェーンがあります。新しいスワップ チェーンが全画面表示スワップ チェーンの場合、アダプターは新しいサイズに合わせた表示モードに設定されます。

Reset が、リセットするデバイスを作成したスレッドと異なるスレッドで呼び出された場合、呼び出しは失敗します。

ウィンドウ モードの場合は、Device、Reset、および SwapChain を呼び出すときに、バック バッファー形式に "unknown" を指定できます。つまり、ウィンドウ モードの場合は、アプリケーションが Device を呼び出す前に現在のデスクトップ形式を照会する必要はありません。全画面表示モードの場合は、バック バッファー形式を指定する必要があります。BackBufferCount を 0 に設定すると、バック バッファーが 1 つ作成されます。

グループ内で複数のディスプレイ アダプターをリセットする場合は、アダプター グループ内のディスプレイごとに 1 つの PresentParameters オブジェクトの配列を渡します。

.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

参照

参照

Device クラス

Device メンバー

Microsoft.WindowsMobile.DirectX.Direct3D 名前空間