Share via


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

Cria uma nova instância do IWICBitmapDecoder com base no identificador de arquivo especificado.

Sintaxe

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

Parâmetros

[in] hFile

Tipo: ULONG_PTR

O identificador de arquivo do qual criar o decodificador.

[in] pguidVendor

Tipo: const GUID*

O GUID para o fornecedor de decodificador preferencial. Use NULL se nenhum fornecedor preferencial.

[in] metadataOptions

Tipo: WICDecodeOptions

O WICDecodeOptions a ser usado ao criar o decodificador.

[out, retval] ppIDecoder

Tipo: IWICBitmapDecoder**

Um ponteiro que recebe um ponteiro para um novo IWICBitmapDecoder.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Quando um decodificador é criado usando esse método, o identificador de arquivo deve permanecer ativo durante o tempo de vida do decodificador.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincodec.h
Biblioteca Windowscodecs.lib
DLL Windowscodecs.dll

Confira também

CreateFile

IWICImagingFactory