Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IWICDdsEncoder::CreateNewFrame method

Creates a new frame to encode.

Syntax


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

Parameters

ppIFrameEncode [out]

A pointer to the newly created frame object.

pArrayIndex [out, optional]

Points to the location where the array index is returned.

pMipLevel [out, optional]

Points to the location where the mip level index is returned.

pSliceIndex [out, optional]

Points to the location where the slice index is returned.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This is equivalent to IWICBitmapEncoder::CreateNewFrame, but returns additional information about the array index, mip level and slice of the newly created frame. In contrast to IWICBitmapEncoder::CreateNewFrame, there is no IPropertyBag2* parameter because individual DDS frames do not have separate properties.

Requirements

Minimum supported client

Windows 8.1 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 R2 [desktop apps | Windows Store apps]

Header

Wincodec.h

IDL

Wincodec.idl

Library

Windowscodecs.lib

DLL

Windowscodecs.dll

See also

IWICDdsEncoder
WICDdsParameters

 

 

Community Additions

Show:
© 2015 Microsoft