Metodo ICodecAPI::SetValueWithNotify (strmif.h)

Articolo
07/28/2023

[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
S_OK	Il metodo è riuscito.
E_NOTIMPL	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

Vedi anche

Informazioni di riferimento sulle API codec

API codificatore

ICodecAPI

ICodecAPI::GetValue

Share via