Método IMediaDet::p ut_Filter

[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 put_Filter método especifica um filtro de origem para o detector de mídia a ser usado.

Importante

Não adicione o filtro de origem ao seu próprio grafo de filtro ou use um filtro que já esteja em um grafo de filtro. O objeto detector de mídia cria automaticamente um grafo de filtro interno e colocar o filtro em outro grafo pode causar resultados inesperados.

 

Sintaxe

HRESULT put_Filter(
  [in] IUnknown *newVal
);

Parâmetros

newVal [in]

Ponteiro para a interface IUnknown do filtro de origem.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes:

Código de retorno Descrição
S_OK
Êxito.
E_NOINTERFACE
newVal não aponta para um filtro.
E_POINTER
Argumento de ponteiro NULL.

 

Comentários

Para a maioria dos aplicativos, é mais simples chamar o método IMediaDet::p ut_Filename com o nome de um arquivo de origem.

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

IMediaDet Interface

Códigos de erro e êxito