Freigeben über


IWICImagingFactory::CreateDecoderFromFilename-Methode (wincodec.h)

Erstellt eine neue instance der IWICBitmapDecoder-Klasse basierend auf der angegebenen Datei.

Syntax

HRESULT CreateDecoderFromFilename(
  [in]          LPCWSTR           wzFilename,
  [in]          const GUID        *pguidVendor,
  [in]          DWORD             dwDesiredAccess,
  [in]          WICDecodeOptions  metadataOptions,
  [out, retval] IWICBitmapDecoder **ppIDecoder
);

Parameter

[in] wzFilename

Typ: LPCWSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen eines zu erstellenden oder zu öffnenden Objekts angibt.

[in] pguidVendor

Typ: const GUID*

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

[in] dwDesiredAccess

Art: DWORD

Der Zugriff auf das -Objekt, das lese-, schreib- oder beides sein kann.

Wert Bedeutung
GENERIC_READ
Lesezugriff.
GENERIC_WRITE
Schreibzugriff.
 

Weitere Informationen finden Sie unter Generische Zugriffsrechte.

[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 den 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.

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