CRenderTarget::CreateCompatibleRenderTarget

在与当前呈现器目标兼容的中间屏幕外绘图期间,创建新的位图呈现器目标以供使用。

BOOL CreateCompatibleRenderTarget(
   CBitmapRenderTarget& bitmapTarget,
   CD2DSizeF sizeDesired = CD2DSizeF(0.,
   0.),
   CD2DSizeU sizePixelDesired = CD2DSizeU(0,
   0),
   D2D1_PIXEL_FORMAT* desiredFormat = NULL,
   D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options = D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS_NONE
);

参数

  • bitmapTarget
    当此方法返回时,将包含指向新位图呈现器目标的指针的地址。 该参数未经初始化即被传递。

  • sizeDesired
    如果所需的新呈现器目标的大小应不同于原始呈现器目标或为 NULL,则用与设备无关的像素表示大小。 有关更多信息,请参见“备注”一节。

  • sizePixelDesired
    如果所需的新呈现器目标的大小应不同于原始呈现器目标或为 NULL,则用像素表示大小。 有关更多信息,请参见“备注”一节。

  • desiredFormat
    需要的新呈现器目标的像素格式和 alpha 模式,或者为 NULL。 如果像素格式设置为 DXGI_FORMAT_UNKNOWN,或者此参数为 NULL,则新呈现器目标使用相同的像素格式作为原始呈现器目标。 如果 alpha 模式是 D2D1_ALPHA_MODE_UNKNOWN,或者此参数为 NULL,则新呈现器目标的 alpha 模式会默认为 D2D1_ALPHA_MODE_PREMULTIPLIED。 有关支持的像素格式的信息,请参见支持的像素格式和 Alpha 模式。

  • options
    指定新的呈现器目标是否必须与 GDI 兼容的值。

返回值

如果该方法成功,则返回 TRUE。 否则,返回 FALSE。

要求

标头: afxrendertarget.h

请参见

参考

CRenderTarget 类