LPD3DHAL_CONTEXTDESTROYCB回呼函式 (d3dhal.h)

發行項
02/25/2024

D3dContextDestroy 函式會刪除指定的內容。

語法

LPD3DHAL_CONTEXTDESTROYCB Lpd3dhalContextdestroycb;

DWORD Lpd3dhalContextdestroycb(
  LPD3DHAL_CONTEXTDESTROYDATA unnamedParam1
)
{...}

參數

unnamedParam1

pcdd [in]

指向包含驅動程序終結內容所需資訊的 D3DHAL_CONTEXTDESTROYDATA 結構。

傳回值

D3dContextDestroy 會傳回下列其中一個回呼代碼：

備註

所有 Microsoft Direct3D 驅動程式都必須支援 D3dContextDestroy。

驅動程式應該釋出配置給所刪除內容的所有資源。例如，驅動程式應該釋放與內容相關聯的下列資源：

紋理資源
頂點和像素著色器
頂點著色器的宣告和程序代碼
異步查詢的資源

驅動程式不應該釋出與內容相關聯的 Microsoft DirectDraw 表面，因為 DirectDraw 會釋出這些介面，以回應應用程式或 Direct3D 運行時間要求。

如果驅動程式在呼叫 D3dContextCreate 時，快取傳入做為 D3DHAL_CONTEXTCREATEDATA 結構的lpDDLcl 成員DD_DIRECTDRAW_LOCAL結構的指標，則呼叫 D3dContextDestroy 之前，指標可能會變成無效。因此， D3dContextDestroy 不得取值此DD_DIRECTDRAW_LOCAL指標，因為可能會傳回存取違規的結果或隨機數據。例如，如果驅動程式的 D3dDestroyDDLocal 函式在 D3dContextDestroy 之前呼叫，操作系統會在 D3dContextDestroy 呼叫之前釋放此DD_DIRECTDRAW_LOCAL指標。

您可以使用停用的 PDEV 呼叫 D3dContextDestroy。藉由呼叫顯示器驅動程式的 DrvAssertMode 函式來停用或啟用PDEV。如需詳細資訊，請參閱管理 PDEV 。