Método ICodecAPI::SetValueWithNotify (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El método SetValueWithNotify establece una propiedad en un códec y devuelve una lista de otras propiedades que cambiaron como resultado.
Sintaxis
HRESULT SetValueWithNotify(
[in] const GUID *Api,
[in] VARIANT *Value,
[out] GUID **ChangedParam,
[out] ULONG *ChangedParamCount
);
Parámetros
[in] Api
Puntero a un GUID que especifica la propiedad que se va a establecer. Para obtener una lista de las propiedades de códec estándar, consulte Propiedades de la API de códec.
[in] Value
Puntero a un valor VARIANT que contiene el nuevo valor de la propiedad.
[out] ChangedParam
Recibe un puntero a una matriz de GUID. La matriz contiene los GUID de las propiedades que han cambiado como resultado de esta llamada al método. El autor de la llamada debe liberar la matriz llamando a CoTaskMemFree.
[out] ChangedParamCount
Recibe el número de elementos de la matriz ChangedParam .
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
Sin implementar. |
Observaciones
Los códecs que implementan ICodecAPI no son necesarios para admitir este método.
Requisitos
| Cliente mínimo compatible | Windows XP con SP2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 R2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluya Dshow.h) |
| Library | Strmiids.lib |