IWICImagingFactory::CreateDecoderFromFileHandle-Methode (wincodec.h)

Erstellt eine neue instance des IWICBitmapDecoder basierend auf dem angegebenen Dateihandle.

Syntax

HRESULT CreateDecoderFromFileHandle(
  [in]          ULONG_PTR         hFile,
  [in]          const GUID        *pguidVendor,
  [in]          WICDecodeOptions  metadataOptions,
  [out, retval] IWICBitmapDecoder **ppIDecoder
);

Parameter

[in] hFile

Typ: ULONG_PTR

Das Dateihandle, aus dem der Decoder erstellt werden soll.

[in] pguidVendor

Typ: const GUID*

Die GUID für den bevorzugten Decoderanbieter. Verwenden Sie NULL , wenn kein bevorzugter Anbieter vorhanden ist.

[in] metadataOptions

Typ: WICDecodeOptions

Die WICDecodeOptions , die beim Erstellen des Decoders verwendet werden sollen.

[out, retval] ppIDecoder

Typ: IWICBitmapDecoder**

Ein Zeiger, der einen Zeiger auf einen neuen IWICBitmapDecoder empfängt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn ein Decoder mit dieser Methode erstellt wird, muss das Dateihandle während der Lebensdauer des Decoders aktiv bleiben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincodec.h
Bibliothek	Windowscodecs.lib
DLL	Windowscodecs.dll

Weitere Informationen

CreateFile

IWICImagingFactory