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 |
|
|
IDL |
|
|
Library |
|
|
DLL |
|
See also