Método IPropertySetter::AddProp

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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.]

Observação

[Preterido. Essa API pode ser removida de versões futuras do Windows.]

 

O AddProp método adiciona uma propriedade ao setter de propriedade, com uma matriz de pares time-value definindo o valor da propriedade em um intervalo de tempo.

Sintaxe

HRESULT AddProp(
  [in] DEXTER_PARAM Param,
  [in] DEXTER_VALUE *paValue
);

Parâmetros

Param [in]

DEXTER_PARAM estrutura que especifica a propriedade . O membro nValues da estrutura deve ser igual ao tamanho da matriz fornecida no parâmetro paValue .

paValue [in]

Ponteiro para uma matriz de estruturas de DEXTER_VALUE que contêm pares de valor de tempo. A matriz deve estar em ordem de tempo crescente. Os tempos são relativos à hora inicial do efeito ou da transição.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A primeira estrutura DEXTER_VALUE deve especificar um tempo de referência de zero e um sinalizador de interpolação (dwInterp) de DEXTERF_JUMP ou o método retorna um erro.

Observação

O arquivo de cabeçalho Qedit.h não é compatível com cabeçalhos Direct3D posteriores à versão 7.

 

Observação

Para obter qedit.h, baixe o SDK do Microsoft Windows Update para Windows Vista e .NET Framework 3.0. O Qedit.h não está disponível no SDK do Microsoft Windows para Windows 7 e .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito Valor
parâmetro
Qedit.h
Biblioteca
Strmiids.lib

Confira também

IPropertySetter Interface

Códigos de erro e êxito