Método ICodecAPI::SetValueWithNotify (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método SetValueWithNotify define uma propriedade em um codec e retorna uma lista de outras propriedades que foram alteradas como resultado.

Sintaxe

HRESULT SetValueWithNotify(
  [in]  const GUID *Api,
  [in]  VARIANT    *Value,
  [out] GUID       **ChangedParam,
  [out] ULONG      *ChangedParamCount
);

Parâmetros

[in] Api

Ponteiro para um GUID que especifica a propriedade a ser definida. Para obter uma lista de propriedades codec padrão, consulte Propriedades da API codec.

[in] Value

Ponteiro para um VARIANT que contém o novo valor para a propriedade .

[out] ChangedParam

Recebe um ponteiro para uma matriz de GUIDs. A matriz contém os GUIDs de todas as propriedades que foram alteradas como resultado dessa chamada de método. O chamador deve liberar a matriz chamando CoTaskMemFree.

[out] ChangedParamCount

Recebe o número de elementos na matriz ChangedParam .

Retornar valor

Esse método pode retornar um desses valores.

Comentários

Codecs que implementam ICodecAPI não são necessários para dar suporte a esse método.

Requisitos

Confira também

Referência da API do Codec

API do codificador

ICodecAPI

ICodecAPI::GetValue