IWICJpegFrameDecode::SetIndexing-Methode (wincodec.h)

Ermöglicht die Indizierung des JPEG-Steuerelements für einen effizienten zufälligen Zugriff.

Syntax

HRESULT SetIndexing(
  WICJpegIndexingOptions options,
  UINT                   horizontalIntervalSize
);

Parameter

options

Typ: WICJpegIndexingOptions

Ein Wert, der angibt, ob Indizes sofort generiert oder bis zu einem späteren Aufruf von IWICBitmapSource::CopyPixels zurückgestellt werden sollen.

horizontalIntervalSize

Typ: UINT

Die Granularität der Indizierung in Pixel.

Rückgabewert

Typ: HRESULT

Gibt nach erfolgreichem Abschluss S_OK zurück.

Hinweise

Diese Methode ermöglicht einen effizienten zufälligen Zugriff auf die Bildpixel auf Kosten der Speicherauslastung. Die menge des für die Indizierung erforderlichen Arbeitsspeichers hängt von der angeforderten Indexgranularität ab. Wenn SetIndexing nicht aufgerufen wird, ist es viel effizienter, auf ein JPEG zuzugreifen, indem die Pixel während der Aufrufe von IWICBitmapSource::CopyPixels von oben nach unten durchlaufen werden.

Diese Methode schlägt fehl, wenn die Indizierung für die Datei nicht unterstützt wird. IWICJpegFrameDecode::D oesSupportIndexing sollte aufgerufen werden, um zuerst zu bestimmen, ob die Indizierung unterstützt wird. Wenn diese Methode mehrmals aufgerufen wird, ändert der letzte Aufruf die Indexgranularität in die angeforderte Größe.

Die angegebene Intervallgröße steuert den horizontalen Abstand von Indexeinträgen. Dieser Wert wird intern entsprechend der Größe der JPEG-MCU (Minimum Coded Unit) aufgerundet, die in der Regel 8 oder 16 nicht skalierte Pixel beträgt. Die vertikale Größe des Indexintervalls entspricht immer einer MCU-Größe.

Indizes können sofort oder bei zukünftigen Aufrufen von IWICBitmapSource::CopyPixels generiert werden, um redundante Dekomprimierungsarbeit zu reduzieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincodec.h
Bibliothek	Windowscodecs.lib
DLL	Windowscodecs.dll

Weitere Informationen

IWICBitmapSource::CopyPixels

IWICJpegFrameDecode

IWICJpegFrameDecode::ClearIndexing

IWICJpegFrameDecode::D oesSupportIndexing