IWICImagingFactory::CreateBitmap-Methode (wincodec.h)

Erstellt ein IWICBitmap-Objekt .

Syntax

HRESULT CreateBitmap(
  [in]  UINT                       uiWidth,
  [in]  UINT                       uiHeight,
  [in]  REFWICPixelFormatGUID      pixelFormat,
  [in]  WICBitmapCreateCacheOption option,
  [out] IWICBitmap                 **ppIBitmap
);

Parameter

[in] uiWidth

Typ: UINT

Die Breite der neuen Bitmap .

[in] uiHeight

Typ: UINT

Die Höhe der neuen Bitmap.

[in] pixelFormat

Typ: REFWICPixelFormatGUID

Das Pixelformat der neuen Bitmap.

[in] option

Typ: WICBitmapCreateCacheOption

Die Cacheerstellungsoptionen der neuen Bitmap. Dies kann einer der Werte in der WICBitmapCreateCacheOption-Enumeration sein.

Wert Bedeutung
WICBitmapCacheOnDemand
Ordnet systemspeicher für die Bitmap bei der Initialisierung zu.
WICBitmapCacheOnLoad
Weist den Systemspeicher für die Bitmap zu, wenn die Bitmap zum ersten Mal verwendet wird.
WICBitmapNoCache
Diese Option ist für diese Methode ungültig und sollte nicht verwendet werden.

[out] ppIBitmap

Typ: IWICBitmap**

Ein Zeiger, der einen Zeiger auf die neue Bitmap empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP2, Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincodec.h
Bibliothek Windowscodecs.lib
DLL Windowscodecs.dll

Weitere Informationen

IWICImagingFactory

Native Pixelformate