(wincodec.h) IWICJpegFrameDecode：：SetIndexing 方法

啟用 JPEG 的索引，以便有效率的隨機存取。

語法

HRESULT SetIndexing(
  WICJpegIndexingOptions options,
  UINT                   horizontalIntervalSize
);

options

值，指定是否應立即產生索引，或延遲到未來呼叫 IWICBitmapSource：：CopyPixels 為止。

horizontalIntervalSize

類型： UINT

索引的粒度，以像素為單位。

類型： HRESULT

成功完成時傳回S_OK。

這個方法可有效隨機存取影像圖元，但代價是記憶體使用量。索引所需的記憶體數量取決於要求的索引粒度。除非呼叫 SetIndexing ，否則在呼叫 IWICBitmapSource：：CopyPixels 期間，透過其圖元向下進度，以更有效率地存取 JPEG。

如果檔案上不支援索引編製，這個方法將會失敗。應該呼叫 IWICJpegFrameDecode：:D oesSupportIndexing ，先判斷是否支持索引編製。如果多次呼叫此方法，最終呼叫會將索引粒度變更為要求的大小。

提供的間隔大小會控制索引項目的水準間距。此值會根據 JPEG 的 MCU (最小編碼單位) 大小進位，通常是 8 或 16 個未調整的圖元。索引間隔的垂直大小一律等於一個 MCU 大小。

您可以立即產生索引，或在未來的 IWICBitmapSource：：CopyPixels 呼叫期間產生索引，以減少備援解壓縮工作。