IWICDdsEncoder::CreateNewFrame-Methode (wincodec.h)

Erstellt einen neuen Frame zum Codieren.

Syntax

HRESULT CreateNewFrame(
  [out]           IWICBitmapFrameEncode **ppIFrameEncode,
  [out, optional] UINT                  *pArrayIndex,
  [out, optional] UINT                  *pMipLevel,
  [out, optional] UINT                  *pSliceIndex
);

Parameter

[out] ppIFrameEncode

Ein Zeiger auf das neu erstellte Frameobjekt.

[out, optional] pArrayIndex

Zeigt auf den Speicherort, an dem der Arrayindex zurückgegeben wird.

[out, optional] pMipLevel

Zeigt auf die Position, an der der Index der mip-Ebene zurückgegeben wird.

[out, optional] pSliceIndex

Zeigt auf den Speicherort, an dem der Sliceindex zurückgegeben wird.

Rückgabewert

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

Hinweise

Dies entspricht IWICBitmapEncoder::CreateNewFrame, gibt jedoch zusätzliche Informationen über den Arrayindex, die MIP-Ebene und den Slice des neu erstellten Frames zurück. Im Gegensatz zu IWICBitmapEncoder::CreateNewFrame gibt es keinen IPropertyBag2*-Parameter, da einzelne DDS-Frames keine separaten Eigenschaften haben.

Anforderungen

Weitere Informationen

IWICDdsEncoder

WICDdsParameters