Metodo IRenderEngine::SetSourceNameValidation

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Nota

[Deprecata. Questa API può essere rimossa dalle versioni future di Windows.]

 

Il SetSourceNameValidation metodo specifica come il motore di rendering convalida i nomi di file.

Sintassi

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

Parametri

FilterString

Valore BSTR contenente coppie di stringhe di filtro, formattate come richiesto dal membro lpstrFilter della struttura OPENFILENAME . Il localizzatore multimediale usa questo filtro se presenta una finestra di dialogo Apri file all'utente finale.

pOverride

Puntatore facoltativo all'interfaccia IMediaLocator di un localizzatore multimediale da usare al posto dell'impostazione predefinita. Per usare il localizzatore multimediale predefinito, impostare il valore di questo parametro su NULL. Per ulteriori informazioni, vedere la sezione Osservazioni.

Flag

Combinazione bit per bit dei flag di convalida del nome file che specifica il comportamento del localizzatore multimediale. Il flag SFN_VALIDATEF_CHECK deve essere presente. Il flag SFN_VALIDATEF_hlinkMUTED non ha alcun effetto con questo metodo.

Valore restituito

Restituisce uno dei valori HRESULT seguenti:

Codice restituito	Descrizione
S_OK	Operazione completata.
E_MUST_INIT_RENDERER	Impossibile inizializzare il motore di rendering.

 

Commenti

Usando il parametro pOverride , è possibile fornire la propria implementazione personalizzata dell'interfaccia IMediaLocator . Ad esempio, il localizzatore multimediale predefinito non invia una notifica a un'applicazione sui file trovati (o non riesce a trovare). Per aggirare questa limitazione, è possibile implementare un localizzatore multimediale personalizzato, rendendolo un wrapper per la versione predefinita. Passare quindi le chiamate IMediaLocator::FindMediaFile direttamente alla versione predefinita ed esaminare il valore restituito.

Attualmente, questo metodo non convalida le origini caricate dinamicamente. Vedere IRenderEngine::SetDynamicReconnectLevel.

Nota

Il file di intestazione Qedit.h non è compatibile con le intestazioni Direct3D successive alla versione 7.

 

Nota

Per ottenere Qedit.h, scaricare l'aggiornamento Microsoft Windows SDK per Windows Vista e .NET Framework 3.0. Qedit.h non è disponibile nella Microsoft Windows SDK per Windows 7 e .NET Framework 3.5 Service Pack 1.

 

Requisiti

Requisito	Valore
Intestazione	Qedit.h
Libreria	Strmiids.lib

Vedi anche

Interfaccia IRenderEngine

Codici di errore e di esito positivo