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
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 |