PDD_DESTROYDDLOCAL

D3dDestroyDDLocal 関数は、同じローカル Microsoft DirectDraw オブジェクトに属する、D3dCreateSurfaceEx 関数によって以前に作成されたすべての Microsoft Direct3D サーフェスを破棄します。

D3dDestroyDDLocal は、次のいずれかのコールバックコードを返します。

すべての Direct3D ドライバーは D3dDestroyDDLocal をサポートする必要があります。

Direct3D は、Direct3D コンテキストがもはや必要ではなく、そのコンテキストに関連付けられたすべてのサーフェスとともに破棄されることをアプリケーションが示したときに、D3dDestroyDDLocal を呼び出します。この関連付けは、ローカル DirectDraw オブジェクトへのポインターを通じて行われます。ドライバーは、必要に応じて、ドライバーの D3dCreateSurfaceEx コールバックが各サーフェスに対して割り当てたメモリをすべて解放する必要があります。

ドライバーは、これらの Direct3D サーフェスに関連付けられた DirectDraw サーフェスを破棄してはなりません。これはアプリケーションの責任です。

D3dContextCreate が呼び出されたときに D3DHAL_CONTEXTCREATEDATA 構造体の lpDDLcl メンバーとして渡された DD_DIRECTDRAW_LOCAL 構造体へのポインターは、D3dDestroyDDLocal が復帰した後にオペレーティングシステムによって解放されます。

D3dDestroyDDLocal は、無効化された PDEV の状態で呼び出されることがあります。PDEV は、ディスプレイドライバーの DrvAssertMode 関数を呼び出すことによって無効化または有効化されます。詳細については、Managing PDEVs を参照してください。