Método IRenderEngine::SetSourceNameValidation

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

O SetSourceNameValidation método especifica como o mecanismo de renderização valida nomes de arquivo.

Sintaxe

HRESULT SetSourceNameValidation(
   BSTR          FilterString,
   IMediaLocator *pOverride,
   LONG          Flags
);

Parâmetros

FilterString

Valor BSTR que contém pares de cadeias de caracteres de filtro, formatadas conforme exigido pelo membro lpstrFilter da estrutura OPENFILENAME . O localizador de mídia usará esse filtro se apresentar uma caixa de diálogo Abrir Arquivo para o usuário final.

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.

Sinalizadores

Combinação bit a bit de Sinalizadores de Validação de Nome de Arquivo especificando o comportamento do localizador de mídia. O sinalizador SFN_VALIDATEF_CHECK deve estar presente. O sinalizador SFN_VALIDATEF_hlinkMUTED não tem efeito com esse método.

Retornar valor

Retorna um dos seguintes valores 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 notifica um aplicativo sobre os arquivos que ele localiza (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 seguida, passe chamadas IMediaLocator::FindMediaFile diretamente para a versão padrão e examine o valor retornado.

Atualmente, esse método não valida fontes carregadas dinamicamente. Consulte IRenderEngine::SetDynamicReconnectLevel.

Requisitos

Confira também

IRenderEngine Interface

Códigos de erro e êxito