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