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) |