Share via


Método IWICMetadataBlockWriter::SetWriterByIndex (wincodecsdk.h)

Substitui o gravador de metadados no local de índice especificado.

Sintaxe

HRESULT SetWriterByIndex(
  [in] UINT               nIndex,
  [in] IWICMetadataWriter *pIMetadataWriter
);

Parâmetros

[in] nIndex

Tipo: UINT

A posição de índice na qual colocar o gravador de metadados. Esse índice é baseado em zero.

[in] pIMetadataWriter

Tipo: IWICMetadataWriter*

Um ponteiro para o IWICMetadataWriter.

Valor retornado

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

Normalmente, o gravador de metadados atual no índice especificado será substituído pelo novo gravador. No entanto, o gravador de metadados do App0 não pode ser substituído em um fluxo JPEG.

Essa função não pode ser usada para adicionar gravadores de metadados. Se nenhum gravador de metadados existir no índice especificado, a função falhará.

Requisitos

   
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 wincodecsdk.h
Biblioteca Windowscodecs.lib
DLL Windowscodecs.dll

Confira também

Conceitual

Como escrever uma WIC-Enabled CODEC

Instruções: recodificar uma imagem JPEG com metadados

IWICMetadataBlockWriter

Outros recursos

Visão geral dos metadados de imagem de leitura e gravação

Visão geral dos metadados do WIC