PFND3DDDI_OFFERALLOCATIONSCB回呼函式 (d3dumddi.h)
由使用者模式顯示驅動程式呼叫,以提供視訊記憶體配置以供重複使用。
語法
PFND3DDDI_OFFERALLOCATIONSCB Pfnd3dddiOfferallocationscb;
HRESULT Pfnd3dddiOfferallocationscb(
HANDLE hDevice,
const D3DDDICB_OFFERALLOCATIONS *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄(圖形內容)。 Direct3D 運行時間在裝置建立時,會將此句柄傳遞為 hDevice 成員 D3DDDIARG_CREATEDEVICE 的使用者模式驅動程式。
unnamedParam2
pData [in]
D3DDDICB_OFFERALLOCATIONS 結構的指標,定義驅動程式所提供的視訊記憶體配置。
傳回值
傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
S_OK | 已成功提供配置。 注意: 如果驅動程式不需要呼叫 pfnOfferAllocationsCb ,它應該會傳回S_OK。 |
D3DDDIERR_DEVICEREMOVED | 視訊記憶體管理員或顯示迷你埠驅動程式無法完成作業,因為發生隨插即用 (PnP) 停止事件或逾時偵測和復原 (TDR) 事件。 注意: 如果傳回此錯誤碼,驅動程式的呼叫函式(通常是 pfnOfferResources 例程)必須將此錯誤碼傳回 Direct3D 運行時間。 |
E_INVALIDARG | 提供無效的參數。 |
言論
使用者模式顯示驅動程式會呼叫 pfnOfferAllocationsCb pfnOfferAllocationsCb,以通知 Microsoft DirectX 圖形核心子系統,在完成任何先前提交的轉譯作業之後,它可以提供配置記憶體以供其他進程使用。
驅動程式呼叫 pfnOfferAllocationsCb 以提供重複使用的配置之後,必須先呼叫 pfnReclaimAllocationsCb,才能鎖定配置或提交它以進行轉譯作業。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 8 |
支援的最低伺服器 | Windows Server 2012 |
目標平臺 | 桌面 |
標頭 | d3dumddi.h (包括 D3dumddi.h) |