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.]
Observação
[Preterido. Essa API pode ser removida de versões futuras do Windows.]
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 :
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Falha ao inicializar o mecanismo de renderização. |
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.
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 |
|
| Biblioteca |
|
Confira também