CRenderTarget::CreateCompatibleRenderTarget

Erstellt ein neues Bitmaprenderingziel zur Verwendung für das Offscreen-Zwischenzeichnen, das mit dem aktuellen Renderingziel kompatibel ist.

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

Parameter

  • bitmapTarget
    Enthält nach dem Beenden dieser Methode die Adresse eines Zeigers auf ein neues Bitmaprenderingziel.Dieser Parameter wird nicht initialisiert übergeben.

  • sizeDesired
    Die gewünschte Größe des neuen Renderingziels in geräteunabhängigen Pixel, wenn es vom ursprünglichen Renderingziel verschieden ist, oder NULL.Weitere Informationen finden Sie im Abschnitt "Hinweise".

  • sizePixelDesired
    Die gewünschte Größe des neuen Renderingziels in Pixel, wenn es vom ursprünglichen Renderingziel verschieden ist, oder NULL.Weitere Informationen finden Sie im Abschnitt "Hinweise".

  • desiredFormat
    Das gewünschte Pixelformat und der Alphamodus des neuen Renderingziels oder NULL.Wenn das Pixelformat auf DXGI_FORMAT_UNKNOWN festgelegt oder dieser Parameter NULL ist, verwendet das neue Renderingziel das gleiche Pixelformat wie das ursprüngliche Renderingziel.Wenn der Alphamodus D2D1_ALPHA_MODE_UNKNOWN ist oder dieser Parameter den Wert NULL hat, wird der Alphamodus des neuen Renderingziels standardmäßig auf D2D1_ALPHA_MODE_PREMULTIPLIED festgelegt.Informationen zu unterstützten Pixelformaten finden Sie in Unterstützte Pixelformate und Alphamodi.

  • options
    Ein Wert, der angibt, ob das neue Renderingziel mit GDI kompatibel sein muss.

Rückgabewert

Wenn die Methode erfolgreich ist, wird TRUE zurückgegeben.Andernfalls wird FALSE zurückgegeben.

Anforderungen

Header: afxrendertarget.h

Siehe auch

Referenz

CRenderTarget Class