IWICDdsEncoder：：CreateNewFrame 方法 (wincodec.h)

创建要编码的新帧。

语法

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

参数

[out] ppIFrameEncode

指向新创建的帧对象的指针。

[out, optional] pArrayIndex

指向返回数组索引的位置。

[out, optional] pMipLevel

指向返回 mip 级别索引的位置。

[out, optional] pSliceIndex

指向返回切片索引的位置。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

这等效于 IWICBitmapEncoder：：CreateNewFrame，但返回有关新创建的帧的数组索引、mip 级别和切片的其他信息。 与 IWICBitmapEncoder：：CreateNewFrame 相比，没有 IPropertyBag2* 参数，因为单个 DDS 帧没有单独的属性。

要求

另请参阅

IWICDdsEncoder

WICDdsParameters