PDD_DESTROYDDLOCAL コールバック関数 (ddrawint.h)

[アーティクル]
02/26/2024

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

構文

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

パラメーター

unnamedParam1

ドライバーがサーフェスを破棄するために必要な情報を含むDDHAL_DESTROYDDLOCALDATA構造体を指します。

戻り値

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

注釈

すべての Direct3D ドライバーで D3dDestroyDDLocal がサポートされている必要があります。

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

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

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

D3dDestroyDDLocal は、無効な PDEV を使用して呼び出すことができます。 PDEV は、ディスプレイドライバーの DrvAssertMode 関数を呼び出すことによって無効または有効になります。詳細については、「 PDEV の管理」を参照してください。