Método IWICImagingFactory::CreateDecoderFromFilename (wincodec.h)

Artículo
03/03/2024

Crea una nueva instancia de la clase IWICBitmapDecoder basada en el archivo especificado.

Sintaxis

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

Parámetros

[in] wzFilename

Tipo: LPCWSTR

Puntero a una cadena terminada en null que especifica el nombre de un objeto que se va a crear o abrir.

[in] pguidVendor

Tipo: GUID const*

GUID del proveedor de descodificador preferido. Use NULL si no hay ningún proveedor preferido.

[in] dwDesiredAccess

Tipo: DWORD

Acceso al objeto , que se puede leer, escribir o ambos.

Valor	Significado
GENERIC_READ	Acceso de lectura.
GENERIC_WRITE	Acceso de escritura.

Para obtener más información, vea Derechos de acceso genéricos.

[in] metadataOptions

Tipo: WICDecodeOptions

WICDecodeOptions que se va a usar al crear el descodificador.

[out, retval] ppIDecoder

Tipo: IWICBitmapDecoder**

Puntero que recibe un puntero al nuevo IWICBitmapDecoder.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2, Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincodec.h
Library	Windowscodecs.lib