Интерфейс IWICMetadataQueryWriter (wincodec.h)

Статья
08/27/2023

Предоставляет методы для задания или удаления блоков метаданных и элементов кодировщику или его кадрам изображений с помощью выражения запроса метаданных.

Наследование

Интерфейс IWICMetadataQueryWriter наследуется от IWICMetadataQueryReader. IWICMetadataQueryWriter также имеет следующие типы элементов:

Методы

Интерфейс IWICMetadataQueryWriter содержит следующие методы.


IWICMetadataQueryWriter::RemoveMetadataByName Удаляет элемент метаданных из определенного расположения с помощью выражения запроса метаданных.
IWICMetadataQueryWriter::SetMetadataByName Задает для элемента метаданных определенное расположение.

Модуль записи запросов метаданных использует выражения запроса метаданных для задания или удаления метаданных. Дополнительные сведения о языке запросов метаданных см. в статье Общие сведения о языке запросов метаданных.

Примеры

В следующем коде показано, как создать модуль записи запросов XMP и добавить в него новый элемент метаданных.

// 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);
}

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	wincodec.h