IDirectDraw インターフェイス

IDirectDraw インターフェイスは、DirectShow マルチメディア ストリーミング API で使われる DirectDraw オブジェクト上で公開されるが、便宜上 DirectShow のドキュメントに含まれている。

DirectDraw オブジェクトはディスプレイ ハードウェアを表す。このオブジェクトがインスタンス化するディスプレイ デバイスがハードウェア アクセラレーション機能を持っている場合、このオブジェクトはハードウェアによってアクセラレートされる。DirectDraw オブジェクトによって作成できるオブジェクトは、DirectDrawSurface オブジェクト、DirectDrawPalette オブジェクト、DirectDrawClipper オブジェクトの 3 つである。

DirectDraw オブジェクトは、作成するすべてのオブジェクトを管理する。このオブジェクトは、プライマリ サーフェイスが 8 bpp モードである場合のデフォルトのパレット、デフォルトのカラー キー値、ハードウェアのディスプレイ モードを制御する。また、割り当て済みのリソースとこれから割り当てるリソースも識別される。

ディスプレイ モードの変更は、DirectDraw の重要な機能の 1 つである。ディスプレイ モードの解像度は、他のアプリケーションが排他的に DirectDraw にアクセスしていない限り、いつでも変更できる。ディスプレイ モードのピクセル深度は、変更を要求しているアプリケーションが DirectDraw オブジェクトに排他的にアクセスしている場合にのみ変更できる。ディスプレイ モードを変更すると、すべての DirectDrawSurface オブジェクトはサーフェイス メモリを失い、機能しなくなる。これらのサーフェイスのメモリは、Restore メソッドを使って再割り当てする必要がある。

IUnknown から継承したメソッドに加えて、IDirectDraw インターフェイスは次のメソッドを公開する。