PFND3DDDI_TEXBLT回呼函式 (d3dumddi.h)
TexBlt 函式會執行從來源紋理到目的地紋理的位區塊傳輸(bitblt)作業,包括來源紋理的所有子層級。
語法
PFND3DDDI_TEXBLT Pfnd3dddiTexblt;
HRESULT Pfnd3dddiTexblt(
HANDLE hDevice,
const D3DDDIARG_TEXBLT *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄(圖形內容)。
unnamedParam2
pData [in]
定義紋理位運算參數之 D3DDDIARG_TEXBLT 結構的指標。
傳回值
TexBlt 傳回S_OK,如果紋理 bitblt 作業未成功執行,則傳回適當的錯誤結果。
言論
Microsoft Direct3D 運行時間會呼叫使用者模式顯示驅動程式的 TexBlt 函式,以通知驅動程式從來源紋理到目的地紋理執行 bitblt 作業。 紋理也可以是立方環境地圖。 驅動程式應該將來源紋理中 D3DDDIARG_TEXBLT 結構 SrcRect 所指定的矩形 成員複製到目的地紋理中 DstPoint D3DDDIARG_TEXBLT 成員所指定的位置。 目的地和來源紋理是由 hDstResource 和 hSrcResource 句柄分別識別D3DDDIARG_TEXBLT。
針對 MIP 對應的紋理,驅動程式也必須複製來源紋理中存在的所有 MIP 對應子層級。 來源和目的地紋理可能包含不同數目的 MIP 地圖層級。 在此情況下,驅動程式應該複製一般層級。 例如,如果 256x256 來源紋理有八個 MIP 地圖層級,而且目的地是具有六個層級的 64x64 紋理,則驅動程式應該從來源複製六個對應的層級。 請注意,目的地紋理上層 MIP 層級的維度一律小於或等於來源紋理上層 MIP 層級的維度。
來源和目的地句柄一律會參考最上層表面,且永遠不會參考任何 MIP 對應子層級。
若要複製 MIP 地圖紋理的任意層級,運行時間會改為呼叫驅動程式的 Blt 函式。
來源和目的地紋理的像素格式完全相同,一般而言,指定的 bitblt 作業是安全的。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
目標平臺 | 桌面 |
標頭 | d3dumddi.h (包括 D3dumddi.h) |