共用方式為


PFND3DDDI_OFFERALLOCATIONSCB回呼函式 (d3dumddi.h)

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

語法

PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;

HRESULT Pfnd3dddiOfferallocationscb(
  HANDLE hDevice,
  const D3DDDICB_OFFERALLOCATIONS *unnamedParam2
)
{...}

參數

hDevice

顯示裝置的句柄 (圖形內容) 。 Direct3D 運行時間在裝置建立時傳遞此句柄做為D3DDDIARG_CREATEDEVICE結構的 hDevice 成員。

unnamedParam2

pData [in]

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

傳回值

傳回下列其中一個值。

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

備註

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

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

規格需求

需求
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
目標平台 桌面
標頭 d3dumddi.h (包含 D3dumddi.h)

另請參閱

D3DDDIARG_CREATEDEVICE

D3DDDICB_OFFERALLOCATIONS

D3DDDI_DEVICECALLBACKS

pfnOfferResources

pfnReclaimAllocationsCb