drvCopyBits 函式 (winddi.h)

DrvCopyBits 函式會在裝置管理的點陣表面與 GDI 標準格式位圖之間轉譯。

語法

BOOL DrvCopyBits(
  SURFOBJ  *psoDest,
  SURFOBJ  *psoSrc,
  CLIPOBJ  *pco,
  XLATEOBJ *pxlo,
  RECTL    *prclDest,
  POINTL   *pptlSrc
);

參數

psoDest

複製作業目的地 SURFOBJ 結構的指標。

psoSrc

複製作業的來源 SURFOBJ 結構的指標。

pco

CLIPOBJ 結構的指標,定義目的地介面上的剪輯區域。

pxlo

XLATEOBJ 結構的指標,定義來源和目標介面之間的色彩索引轉譯。 如果 pxlo 為 NULL,則不需要翻譯。

prclDest

RECTL 結構的指標,定義要修改的區域。 這個結構會使用目的地介面的座標系統。 這個矩形的下邊緣和右邊緣不是位區塊傳輸的一部分,這表示矩形是右下角獨佔的。

DrvCopyBits 永遠不會使用空的目的地矩形呼叫。 定義矩形的兩個點一律會妥善排序。

pptlSrc

定義來源矩形左上角之 POINTL 結構的指標。

傳回值

如果來源介面成功複製到目的地介面,則傳回值為 TRUE 。

備註

驅動程式可以選擇性地攔截 DrvCopyBits。 如果是的話,GDI 會在需要從一個表面複製到另一個表面時呼叫 DrvCopyBits ,而且至少有一個表面是受裝置管理的。

規格需求

需求 值
目標平台 桌面
標頭 winddi.h (包括 Winddi.h)

另請參閱

CLIPOBJ

XLATEOBJ