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 |
|---|---|
|
Operazione completata. |
|
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 |
|
| Libreria |
|
Vedi anche