Interface IWICMetadataQueryWriter (wincodec.h)

Artigo
03/03/2024

Expõe métodos para definir ou remover blocos de metadados e itens para um codificador ou seus quadros de imagem usando uma expressão de consulta de metadados.

Herança

A interface IWICMetadataQueryWriter herda de IWICMetadataQueryReader. IWICMetadataQueryWriter também tem estes tipos de membros:

Métodos

A interface IWICMetadataQueryWriter tem esses métodos.


IWICMetadataQueryWriter::RemoveMetadataByName Remove um item de metadados de um local específico usando uma expressão de consulta de metadados.
IWICMetadataQueryWriter::SetMetadataByName Define um item de metadados como um local específico.

Comentários

Um gravador de consulta de metadados usa expressões de consulta de metadados para definir ou remover metadados. Para obter mais informações sobre a linguagem de consulta de metadados, consulte a Visão geral da linguagem de consulta de metadados.

Exemplos

O código a seguir demonstra como criar um gravador de consulta XMP e adicionar um novo item de metadados a ele.

// Create XMP block
IWICMetadataQueryWriter *pXMPWriter = NULL;

if (SUCCEEDED(hr))
{
    hr = pFactory->CreateQueryWriter(GUID_MetadataFormatXMP, NULL, &pXMPWriter);
}

// Write metadata to the XMP writer
if (SUCCEEDED(hr))
{
    PROPVARIANT value;
    PropVariantInit(&value);

    value.vt = VT_LPWSTR;
    value.pwszVal = L"Metadata Test Image.";
	
    hr = pXMPWriter->SetMetadataByName(L"/dc:title", &value);

    PropVariantClear(&value);
}

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