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.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Não implementado. |
Comentários
Codecs que implementam ICodecAPI não são necessários para dar suporte a esse método.
Requisitos
| Cliente mínimo com suporte | Windows XP com SP2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |