ITranscodeImage::TranscodeImage-Methode (imagetranscode.h)

Artikel
08/24/2023

Konvertiert ein Bild in ein JPEG- oder Bitmapformat (BMP).

Syntax

HRESULT TranscodeImage(
  [in]            IShellItem *pShellItem,
                  UINT       uiMaxWidth,
                  UINT       uiMaxHeight,
                  DWORD      flags,
                  IStream    *pvImage,
  [out, optional] UINT       *puiWidth,
  [out, optional] UINT       *puiHeight
);

Parameter

[in] pShellItem

Typ: IShellItem*

Das Shellelement für das zu konvertierende Image.

uiMaxWidth

Typ: UINT

Die angeforderte Höhe in Pixel. Sollte kleiner oder gleich der tatsächlichen Höhe des originalen Bilds sein. Siehe Hinweise.

uiMaxHeight

Typ: UINT

Die angeforderte Breite in Pixel. Sollte kleiner oder gleich der tatsächlichen Breite des ursprünglichen Bilds sein. Siehe Hinweise.

flags

Typ: TI_FLAGS

Eines der folgenden Flags.

TI_BITMAP

Konvertieren Sie das Bild in das BMP-Format.

TI_JPEG

Konvertieren Sie das Bild in das JPEG-Format.

pvImage

Typ: IStream*

Ein Stream zum Empfangen des konvertierten Bilds. Der Stream muss vom aufrufenden Code erstellt werden, bevor TranscodeImage aufgerufen wird.

[out, optional] puiWidth

Typ: UINT*

Die tatsächliche Breite des konvertierten Bilds.

[out, optional] puiHeight

Typ: UINT*

Die tatsächliche Höhe des konvertierten Bilds.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das Seitenverhältnis des ursprünglichen Bilds wird beibehalten. Die Größe des neuen Bilds wird so geändert, dass es in ein Feld mit der Breite uiMaxWidth und der Höhe uiMaxHeight passt.

Die Bildgröße wird nicht geändert, wenn das ursprüngliche Bild bereits in dieses Begrenzungsfeld passt.

Wenn sowohl uiMaxWidth als auch uiMaxHeight null sind, hat das zurückgegebene Bild dieselbe Größe wie das Original.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	imagetranscode.h

Freigeben über