IWICMetadataQueryWriter 介面 (wincodec.h)

發行項
03/03/2024

使用元數據查詢表達式，將元數據區塊和專案設定或移除至編碼器或其影像框架的方法。

繼承

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 搭配 SP2、Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	wincodec.h