PFND3DDDI_DEALLOCATE2CB回呼函式 (d3dumddi.h)
pfnDeallocate2Cb 使用者模式回呼函式會在建立資源物件時釋放核心模式資源物件的配置。
pfnDeallocate2Cb 是 pfnDeallocateCb 的取代專案，其具有額外的 Flags 成員。 當 Flags 設定為所有零時，行為相當於 pfnDeallocateCb。
語法
PFND3DDDI_DEALLOCATE2CB Pfnd3dddiDeallocate2cb;
HRESULT Pfnd3dddiDeallocate2cb(
HANDLE hDevice,
const D3DDDICB_DEALLOCATE2 *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄 (圖形內容) 。
unnamedParam2
pData [in]
描述要釋放之資源的 D3DDDICB_DEALLOCATE2 結構的指標。
傳回值
| 傳回碼 | 描述 |
|---|---|
| S_OK | 已成功釋放記憶體。 |
| E_INVALIDARG | 已驗證參數，並判斷為不正確。 |
此函式也可能傳回其他 HRESULT 值。
備註
收到配置解構要求時，VidMm 預設會假設在解構要求之前排入佇列的命令可能會存取被終結的配置，並延遲解構作業，直到佇列命令完成為止。 如果使用者模式驅動程式 (UMD) 知道擱置的命令不會存取正在終結的配置，它可以指示 VidMm 在呼叫 pfnDeallocate2Cb 時，不要等待暫止命令完成，方法是將 AssumeNotInUse 旗標設定為 TRUE。
例如，如果應用程式或 UMD 想要確保 從 pfnDeallocate2Cb (呼叫傳回之前回收配置記憶體，例如，若要在重新建立表面) 時將尖峰記憶體使用量降到最低，它應該設定 SynchronousDestroy 旗 標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 |
| 最低支援的伺服器 | Windows Server 2016 |
| 目標平台 | 桌面 |
| 標頭 | d3dumddi.h (包含 D3dumddi.h) |