Interface IMediaLocator

[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.]

 

A IMediaLocator interface fornece métodos para validar nomes de arquivo no DES (DirectShow Editing Services ). Use essa interface para garantir que um determinado nome de arquivo e caminho correspondam a um arquivo existente. Essa interface também fornece uma maneira de pesquisar o arquivo em outros locais e exibir uma caixa de diálogo Abrir para que o usuário possa localizar o arquivo.

O localizador de mídia implementa essa interface. O linha do tempo e o mecanismo de renderização também dão suporte à validação de nome de arquivo por meio dos seguintes métodos:

• IAMTimeline::ValidateSourceNames: valida e atualiza nomes de arquivo no linha do tempo.
• IRenderEngine::SetSourceNameValidation: especifica como o mecanismo de renderização valida nomes de arquivo no momento da renderização.

Normalmente, um aplicativo DES chamará esses métodos em vez de criar diretamente uma instância do localizador de mídia. Para obter mais informações, consulte Usando o Localizador de Mídia.

Membros

A interface IMediaLocator herda da interface IUnknown . O IMediaLocator também tem esses tipos de membros:

• Métodos

Métodos

A interface IMediaLocator tem esses métodos.

Método	Descrição
AddFoundLocation	Adiciona um diretório ao cache de diretório.
FindMediaFile	Pesquisa um arquivo e, se bem-sucedido, recupera o caminho para o arquivo.

 

Comentários

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