PFND3D10DDI_DESTROYDEVICE回呼函式 (d3d10umddi.h)

  • 發行項

DestroyDevice (D3D10) 函式會終結指定的裝置物件。

語法

PFND3D10DDI_DESTROYDEVICE Pfnd3d10ddiDestroydevice;

void Pfnd3d10ddiDestroydevice(
  D3D10DDI_HDEVICE unnamedParam1
)
{...}

參數

unnamedParam1

hDevice

顯示裝置的句柄 (圖形內容) 。 Microsoft Direct3D 運行時間會釋放先前為物件配置的記憶體區域。 因此，驅動程式無法再存取此記憶體區域。

傳回值

無

備註

驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。

在 Direct3D 執行時間呼叫 DestroyDevice (D3D10) 之前，它會終結所有顯示裝置的子物件， (混合狀態、資源等) 。

除了D3DDDIERR_DEVICEREMOVED以外，驅動程式不應該發生任何錯誤。 因此，如果在呼叫 pfnSetErrorCb 函式時，驅動程式會傳遞任何錯誤，但除了 D3DDDIERR_DEVICEREMOVED 之外，Direct3D 運行時間會判斷錯誤是否重要。 即使裝置已移除，驅動程式也不需要傳回D3DDDIERR_DEVICEREMOVED;不過，如果裝置移除干擾 DestroyDevice (D3D10) ( 通常不應該發生) ，驅動程式就可以傳回D3DDDIERR_DEVICEREMOVED。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 d3d10umddi.h (包含 D3d10umddi.h)

另請參閱

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb