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 |
---|---|
|
La operación se completó correctamente. |
|
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. |
|
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 |