Compartir a través de


Método IFilter::GetValue (filter.h)

Recupera un valor (propiedad de tipo valor interno) de un fragmento, que debe tener un CHUNKSTATE valor de enumeración de CHUNK_VALUE.

Sintaxis

SCODE GetValue(
  [out] PROPVARIANT **ppPropValue
);

Parámetros

[out] ppPropValue

Puntero a una variable de salida que recibe un puntero a la estructura PROPVARIANT que contiene la propiedad value-type.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
La operación se completó correctamente.
FILTER_E_NO_MORE_VALUES
Ya se ha llamado al método GetValue en este fragmento; Este valor debe devolverse hasta que se haya llamado correctamente al método IFilter::GetChunk y haya avanzado hasta el siguiente fragmento.
FILTER_E_NO_VALUES
El fragmento actual no tiene un CHUNKSTATE valor de enumeración de CHUNK_VALUE.

Observaciones

Llame al método GetValue solo una vez por fragmento.

Tenga en cuenta que el efecto de producir el mismo valor a partir de más de un fragmento no está definido. Solo la última configuración del valor es válida.

notas de a los autores de llamadas

Asigne la estructura PROPVARIANT con CoTaskMemAlloc. Algunas estructuras de PROPVARIANT contienen punteros, que se pueden liberar llamando a la función PropVariantClear. Depende del autor de la llamada del método GetValue llamar a PropVariantClear.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de filter.h

Consulte también

IFilter