PFND3DDDI_TEXBLT回呼函式 (d3dumddi.h)

  • 發行項

TexBlt 函式會執行位區塊傳輸 (bitblt) 作業，從來源紋理到目的地紋理，包括來源紋理的所有子層級。

語法

PFND3DDDI_TEXBLT Pfnd3dddiTexblt;

HRESULT Pfnd3dddiTexblt(
  HANDLE hDevice,
  const D3DDDIARG_TEXBLT *unnamedParam2
)
{...}

參數

hDevice

顯示裝置的句柄 (圖形內容) 。

unnamedParam2

pData [in]

定義紋理位運算參數 之D3DDDIARG_TEXBLT 結構的指標。

傳回值

如果紋理 bitblt 作業未順利執行，TexBlt 會傳回S_OK或適當的錯誤結果。

備註

Microsoft Direct3D 運行時間會呼叫使用者模式顯示驅動程式的 TexBlt 函式，通知驅動程式從來源紋理到目的地紋理執行 bitblt 作業。 紋理也可以是立方環境地圖。 驅動程式應該將來源紋理中D3DDDIARG_TEXBLT結構的 SrcRect 成員所指定的矩形複製到目的地紋理中D3DDDIARG_TEXBLT的 DstPoint 成員所指定的位置。 目的地和來源紋理會分別由 D3DDDIARG_TEXBLT 的 hDstResource 和 hSrcResource 句柄識別。

針對 MIP 對應的紋理，驅動程式也必須複製來源紋理中存在的所有 MIP 對應子層級。 來源和目的地紋理可能包含不同數目的 MIP 對應層級。 在此情況下，驅動程式應該複製通用層級。 例如，如果 256x256 來源紋理有八個 MIP 對應層級，而且目的地是具有六個層級的 64x64 紋理，則驅動程式應該從來源複製六個對應的層級。 請注意，目的地紋理上層 MIP 層級的維度一律小於或等於來源紋理最上層 MIP 層級的維度。

來源和目的地句柄一律參考最上層表面，且永遠不會參考任何 MIP 對應子層級。

若要複製 MIP 對應紋理的任意層級，運行時間會改為呼叫驅動程式的 Blt 函式。

來源和目的地紋理的圖元格式完全相同，一般而言，指定的 bitblt 作業是安全的執行。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 d3dumddi.h (include D3dumddi.h)

另請參閱

Blt

D3DDDIARG_TEXBLT

D3DDDI_DEVICEFUNCS