PFND3DDDI_RECLAIMRESOURCES回呼函式 (d3dumddi.h)

發行項
02/23/2024

由 Microsoft Direct3D 執行時間呼叫，以回收先前提供給重複使用的視訊記憶體資源。

語法

PFND3DDDI_RECLAIMRESOURCES Pfnd3dddiReclaimresources;

HRESULT Pfnd3dddiReclaimresources(
  HANDLE hDevice,
  const D3DDDIARG_RECLAIMRESOURCES *unnamedParam2
)
{...}

參數

hDevice

顯示裝置的句柄 (圖形內容) 。

unnamedParam2

pData [in]

定義要回收之視訊記憶體資源的 D3DDDIARG_RECLAIMRESOURCES 結構的指標。

傳回值

傳回下列其中一值：

傳回碼	描述
S_OK	已成功回收視訊記憶體資源。如果驅動程式不需要呼叫 pfnReclaimAllocationsCb 函式，就會傳回此錯誤碼。
E_INVALIDARG	提供無效的參數。如果驅動程式呼叫 pfnReclaimAllocationsCb 函式，且該函式傳回E_INVALIDARG，就會傳回此錯誤碼。
D3DDDIERR_DEVICEREMOVED	視訊記憶體管理員或顯示迷你埠驅動程序無法完成作業，因為發生隨插即用 (PnP) Stop 事件或逾時偵測和復原 (TDR) 事件。如果驅動程式呼叫 pfnReclaimAllocationsCb 函式，而且該函式傳回D3DDDIERR_DEVICEREMOVED，就會傳回此錯誤碼。注意：如果傳回此錯誤碼，驅動程式的呼叫函式通常會 (回收ResourcesDXGI 例程) 必須將此錯誤碼傳回 Direct3D 運行時間。