D3DPOOL

[アーティクル]
04/08/2010

リソースのバッファーを保持するメモリークラスを定義します。

typedef enum D3DPOOL
{
    D3DPOOL_DEFAULT = 0,
    D3DPOOL_MANAGED = 1,
    D3DPOOL_SYSTEMMEM = 2,
    D3DPOOL_SCRATCH = 3,
    D3DPOOL_FORCE_DWORD = 0x7fffffff,
} D3DPOOL, *LPD3DPOOL;

定数

D3DPOOL_DEFAULT
リソースは、そのリソースの利用法に最も適したメモリープールに配置されます。通常、これはローカルビデオメモリーと AGP メモリーを含めたビデオメモリーです。D3DPOOL_DEFAULT プールは、D3DPOOL_MANAGED および D3DPOOL_SYTEMMEM とは別で、デバイスによるアクセスに最適なメモリーにリソースを配置するよう指定します。D3DPOOL_DEFAULT は、このリソースに対応するメモリープールのタイプとして D3DPOOL_MANAGED または D3DPOOL_SYSTEMMEM を指定することはないことに注意してください。D3DPOOL_DEFAULT プールに配置されたテクスチャーは、ダイナミックテクスチャーか、プライベートな FOURCC ドライバーフォーマットでない限り、ロックすることはできません。ロックできないテクスチャーにアクセスするには、IDirect3DDevice9::UpdateSurface、IDirect3DDevice9::UpdateTexture、IDirect3DDevice9::GetFrontBufferData、IDirect3DDevice9::GetRenderTargetData のような関数を使用する必要があります。ほとんどのアプリケーションには、D3DPOOL_DEFAULT よりも D3DPOOL_MANAGED の方が適しているでしょう。Direct3D ランタイムが認識しない、ドライバーの独自フォーマットで作成された一部のテクスチャーはロックできることに注意してください。また、テクスチャーとは異なり、スワップチェーンバックバッファー、レンダーターゲット、頂点バッファー、およびインデックスバッファーはロック可能であることに注意してください。デバイスが失われた場合は、IDirect3DDevice9::Reset を呼び出す前に、D3DPOOL_DEFAULT を使って作成したリソースを解放しなければなりません。詳細については、「喪失したデバイス (Direct3D 9)」を参照してください。 D3DPOOL_DEFAULT でリソースを作成するときに、ビデオカードメモリーが使用中である場合は、マネージリソースが削除されて、要求を処理するために必要なメモリーが確保されます。
D3DPOOL_MANAGED
リソースは、必要に応じて、デバイスからアクセス可能なメモリーへ自動的にコピーされます。マネージリソースはシステムメモリーによって保持されるので、デバイスが失われても再作成する必要はありません。詳細については、「リソースの管理 (Direct3D 9)」を参照してください。マネージリソースはロック可能です。直接変更できるのは、システムメモリーのコピーのみです。Direct3D は、加えた変更を、必要に応じてドライバーからアクセス可能なメモリーにコピーします。

Direct3D 9 と Direct3D 9Ex の違い

D3DPOOL_MANAGED は、IDirect3DDevice9 の場合は有効ですが、IDirect3DDevice9Ex の場合は無効です。
D3DPOOL_SYSTEMMEM
リソースは、通常は Direct3D デバイスからアクセスできないメモリーに配置されます。このようなメモリー割り当ては、システム RAM を消費しますが、ページ可能 RAM を減らすことはありません。これらのリソースは、デバイスが失われても再作成の必要はありません。このプール内のリソースは、ロックが可能で、D3DPOOL_DEFAULT を使用して作成されたメモリーリソースに対する IDirect3DDevice9::UpdateSurface または IDirect3DDevice9::UpdateTexture 処理のソースとして使用できます。
D3DPOOL_SCRATCH
リソースはシステム RAM に配置されるので、デバイスが失われても再作成する必要はありません。これらのリソースは、デバイスのサイズやフォーマットによる制約を受けることはありません。このため、これらのリソースは Direct3D デバイスからアクセス不可能で、テクスチャーやレンダーターゲットとして設定することもできません。しかし、これらのリソースを作成、ロック、およびコピーすることは常に可能です。
D3DPOOL_FORCE_DWORD
コンパイル時に、この列挙型のサイズを 32 ビットにするために定義されています。この値を指定しない場合、一部のコンパイラでは列挙型を 32 ビット以外のサイズでコンパイル可能です。この定数が使用されることはありません。

解説　

頂点バッファー、インデックスバッファー、テクスチャー、サーフェスなどのすべてのリソースで、すべてのプールタイプを使用できます。

レンダーターゲット、深度ステンシル、ダイナミック、およびミップマップ用のプールタイプに対する制約を、以下の表に示します。x が記載されている場合は適切な組み合わせ、記載されていない場合は不適切な組み合わせを表しています。

プール	D3DUSAGE_RENDERTARGET	D3DUSAGE_DEPTHSTENCIL
D3DPOOL_DEFAULT	x	x
D3DPOOL_MANAGED
D3DPOOL_SCRATCH
D3DPOOL_SYSTEMMEM

プール	D3DUSAGE_DYNAMIC	D3DUSAGE_AUTOGENMIPMAP
D3DPOOL_DEFAULT	x	x
D3DPOOL_MANAGED		x
D3DPOOL_SCRATCH
D3DPOOL_SYSTEMMEM	x

使用法の詳細については、「D3DUSAGE」を参照してください。

同じリソースに含まれる異なるオブジェクト (ミップマップ内のミップレベル) 用のプールを混在させることはできません。また、一度選択したプールを変更することはできません。

アプリケーションが失われたデバイスを扱わなくて済むよう、ほとんどの静的リソースに対しては、アプリケーションは D3DPOOL_MANAGED を使うべきです(マネージリソースはランタイムで復元されます)。これは、ユニファイドメモリーアーキテクチャ (UMA) システムでは特に大きな利点となります。その他の動的なリソースには、D3DPOOL_MANAGED は適しません。インデックスバッファーと頂点バッファーは、D3DPOOL_MANAGED と D3DUSAGE_DYNAMIC を組み合わせて作成することはできません。

ダイナミックテクスチャーでは、ビデオメモリーとシステムメモリーのテクスチャーを組み合わせ、ビデオメモリーは D3DPOOL_DEFAULT を使って、システムメモリーは D3DPOOL_SYSTEMMEM を使って割り当てることが望ましい場合もあります。システムメモリーのテクスチャーのビットは、ロック用メソッドを使ってロックしたり変更したりすることができます。そして、IDirect3DDevice9::UpdateTexture を使用すると、ビデオメモリーテクスチャーを更新することができます。

要件

ヘッダー: D3D9Types.h 宣言

D3DPOOL

定数

解説

要件

関連項目

その他のリソース