Compartilhar via


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

Cria uma nova instância da classe IWICBitmapDecoder com base no arquivo especificado.

Sintaxe

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

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome de um objeto a ser criado ou aberto.

[in] pguidVendor

Tipo: const GUID*

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

[in] dwDesiredAccess

Tipo: DWORD

O acesso ao objeto , que pode ser lido, gravado ou ambos.

Valor Significado
GENERIC_READ
Acesso de leitura.
GENERIC_WRITE
Acesso de gravação.
 

Para obter mais informações, consulte Direitos de Acesso Genéricos.

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

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