Interfaz IWICMetadataQueryWriter (wincodec.h)

Artículo
03/03/2024

Expone métodos para establecer o quitar bloques de metadatos y elementos en un codificador o sus marcos de imagen mediante una expresión de consulta de metadatos.

Herencia

La interfaz IWICMetadataQueryWriter hereda de IWICMetadataQueryReader. IWICMetadataQueryWriter también tiene estos tipos de miembros:

Métodos

La interfaz IWICMetadataQueryWriter tiene estos métodos.


IWICMetadataQueryWriter::RemoveMetadataByName Quita un elemento de metadatos de una ubicación específica mediante una expresión de consulta de metadatos.
IWICMetadataQueryWriter::SetMetadataByName Establece un elemento de metadatos en una ubicación específica.

Comentarios

Un escritor de consultas de metadatos usa expresiones de consulta de metadatos para establecer o quitar metadatos. Para obtener más información sobre el lenguaje de consulta de metadatos, consulte Información general sobre el lenguaje de consulta de metadatos.

Ejemplos

En el código siguiente se muestra cómo crear un escritor de consultas XMP y agregarle un nuevo elemento de metadatos.

// 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	Value
Cliente mínimo compatible	Windows XP con SP2, Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincodec.h