Platform SDK: DirectX |
IDirectDrawSurface7::GetPriority メソッドは、テクスチャのテクスチャ管理優先順位を取得する。このメソッドは、管理下のテクスチャに対してのみ成功する (「注意」参照)。
HRESULT GetPriority( LPDWORD lpdwPriority );
成功すれば、D3D_OK を返す。
失敗すれば、エラー値を返す。パラメータが無効な場合、またはテクスチャが Direct3D で管理されていない場合、メソッドは DDERR_INVALIDOBJECT を返す。
優先順位を使用して、管理下のテクスチャをメモリからいつ削除するかを決定できる。優先順位が低いテクスチャは、優先順位が高いテクスチャより先に削除される。2 つのテクスチャの優先順位が同じ場合は、最終使用時が新しい方のテクスチャがメモリに保持され、もう一方のテクスチャが削除される。
アプリケーションでは、管理下のテクスチャ (DDSCAPS2_TEXTUREMANAGE フラグで作成したもの) でのみ優先順位を設定および取得できる。非管理下のテクスチャに対してこのメソッドを呼び出すと、メソッドは失敗し、DDERR_INVALIDOBJECT を返す。
このメソッドは、IDirectDrawSurface7 インターフェイスによって導入された。
Windows NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 98 が必要。
ヘッダー : ddraw.h で宣言。