共用方式為


PFND3DDDI_OFFERALLOCATIONS2CB回呼函式 (d3dumddi.h)

由使用者模式顯示驅動程式呼叫,以提供視訊記憶體配置以供重複使用。

語法

PFND3DDDI_OFFERALLOCATIONS2CB Pfnd3dddiOfferallocations2cb;

HRESULT Pfnd3dddiOfferallocations2cb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS2 *unnamedParam2
)
{...}

參數

hDevice

顯示裝置的句柄(圖形內容)。 Direct3D 運行時間在裝置建立時,會將此句柄傳遞為 hDevice 成員 D3DDDIARG_CREATEDEVICE 的使用者模式驅動程式。

unnamedParam2

pData [in]

定義驅動程式所提供的視訊記憶體配置之 D3DDDICB_OFFERALLOCATIONS2 結構的指標。

傳回值

傳回下列其中一個值。

傳回碼 描述
S_OK 已成功提供配置。
注意: 如果驅動程式不需要呼叫 pfnOfferAllocations2Cb ,則應該傳回S_OK。
D3DDDIERR_DEVICEREMOVED 視訊記憶體管理員或顯示迷你埠驅動程式無法完成作業,因為發生隨插即用 (PnP) 停止事件或逾時偵測和復原 (TDR) 事件。
注意: 如果傳回此錯誤碼,驅動程式的呼叫函式(通常是 pfnOfferResources 例程)必須將此錯誤碼傳回 Direct3D 運行時間。
E_INVALIDARG 提供無效的參數。

言論

使用者模式顯示驅動程式會呼叫 pfnOfferAllocations2Cb pfnOfferAllocations2Cb,以通知 Microsoft DirectX 圖形核心子系統,在完成任何先前提交的轉譯作業之後,它可以提供配置記憶體以供其他進程使用。

驅動程式呼叫 pfnOfferAllocations2Cb 以提供重複使用的配置之後,它必須先呼叫 pfnReclaimAllocations3Cb,才能鎖定配置或提交以進行轉譯作業。

pfnOfferAllocations2Cb 函式與 pfnOfferAllocationsCb相同,不同之處在於它會透過 pData 參數考慮旗標。

要求

要求 價值
最低支援的用戶端 Windows 10
支援的最低伺服器 Windows Server 2016
目標平臺 窗戶
標頭 d3dumddi.h (包括 D3dumddi.h)

另請參閱

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS2

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocations3Cb