Interface IWICMetadataQueryWriter (wincodec.h)

Article
03/09/2024

Expose des méthodes pour définir ou supprimer des blocs de métadonnées et des éléments dans un encodeur ou ses images à l’aide d’une expression de requête de métadonnées.

Héritage

L’interface IWICMetadataQueryWriter hérite d’IWICMetadataQueryReader. IWICMetadataQueryWriter possède également les types de membres suivants :

Méthodes

L’interface IWICMetadataQueryWriter contient ces méthodes.


IWICMetadataQueryWriter ::RemoveMetadataByName Supprime un élément de métadonnées d’un emplacement spécifique à l’aide d’une expression de requête de métadonnées.
IWICMetadataQueryWriter ::SetMetadataByName Définit un élément de métadonnées à un emplacement spécifique.

Remarques

Un enregistreur de requête de métadonnées utilise des expressions de requête de métadonnées pour définir ou supprimer des métadonnées. Pour plus d’informations sur le langage de requête de métadonnées, consultez Vue d’ensemble du langage de requête de métadonnées.

Exemples

Le code suivant montre comment créer un enregistreur de requêtes XMP et y ajouter un nouvel élément de métadonnées.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	wincodec.h