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

Crea una nueva instancia del IWICBitmapDecoder en función del identificador de archivo especificado.

Sintaxis

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

Parámetros

[in] hFile

Tipo: ULONG_PTR

Identificador de archivo desde el que se va a crear el descodificador.

[in] pguidVendor

Tipo: GUID const*

GUID del proveedor de descodificador preferido. Use NULL si no es un proveedor preferido.

[in] metadataOptions

Tipo: WICDecodeOptions

WICDecodeOptions que se va a usar al crear el descodificador.

[out, retval] ppIDecoder

Tipo: IWICBitmapDecoder**

Puntero que recibe un puntero a un 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.

Comentarios

Cuando se crea un descodificador mediante este método, el identificador de archivo debe permanecer activo durante la vigencia del descodificador.

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
Archivo DLL	Windowscodecs.dll

Consulte también

CreateFile

IWICImagingFactory