Método IAMTimeline::ValidateSourceNames

[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 ValidateSourceNames método valida os nomes de origem no linha do tempo, usando o localizador de mídia. Opcionalmente, esse método também atualiza qualquer objeto de origem para o qual ele localiza um arquivo.

Sintaxe

HRESULT ValidateSourceNames(
   long          ValidateFlags,
   IMediaLocator *pOverride,
   long          NotifyEventHandle
);

Parâmetros

ValidateFlags

Combinação bit a bit de Sinalizadores de Validação de Nome de Arquivo especificando o comportamento do localizador de mídia. Os sinalizadores SFN_VALIDATEF_REPLACE e SFN_VALIDATEF_CHECK devem estar presentes ou o método retorna E_INVALIDARG.

pOverride

Ponteiro opcional para a interface IMediaLocator de um localizador de mídia a ser usado no lugar do padrão. Para usar o localizador de mídia padrão, defina o valor desse parâmetro como NULL. Confira Comentários para obter mais informações.

NotifyEventHandle

Identificador de um evento. O método sinaliza o evento depois de concluir a validaçã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

Usando o parâmetro pOverride , você pode fornecer sua própria implementação personalizada da interface IMediaLocator . Por exemplo, o localizador de mídia padrão não notificará seu aplicativo sobre os arquivos que ele encontra (ou não pode localizar). Para contornar essa limitação, você pode implementar um localizador de mídia personalizado, tornando-o um wrapper para a versão padrão. Em sua versão personalizada, passe chamadas IMediaLocator::FindMediaFile diretamente para a versão padrão e examine o valor retornado.

Requisitos

Confira também

IAMTimeline Interface

Códigos de erro e êxito