Metodo ICodecAPI::SetValueWithNotify (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il metodo SetValueWithNotify imposta una proprietà su un codec e restituisce un elenco di altre proprietà modificate di conseguenza.
Sintassi
HRESULT SetValueWithNotify(
[in] const GUID *Api,
[in] VARIANT *Value,
[out] GUID **ChangedParam,
[out] ULONG *ChangedParamCount
);
Parametri
[in] Api
Puntatore a un GUID che specifica la proprietà da impostare. Per un elenco delle proprietà del codec standard, vedere Proprietà dell'API codec.
[in] Value
Puntatore a un valore VARIANT contenente il nuovo valore per la proprietà.
[out] ChangedParam
Riceve un puntatore a una matrice di GUID. La matrice contiene i GUID di qualsiasi proprietà modificata in seguito a questa chiamata al metodo. Il chiamante deve liberare la matrice chiamando CoTaskMemFree.
[out] ChangedParamCount
Riceve il numero di elementi nella matrice ChangedParam .
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Non implementato. |
Commenti
I codec che implementano ICodecAPI non sono necessari per supportare questo metodo.
Requisiti
| Client minimo supportato | Windows XP con SP2 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 R2 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |