Metodo IAMTimeline::ValidateSourceNames

[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 ValidateSourceNames metodo convalida i nomi di origine nella sequenza temporale, usando il localizzatore multimediale. Facoltativamente, questo metodo aggiorna anche qualsiasi oggetto di origine per il quale individua un file.

Sintassi

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

Parametri

ValidateFlags

Combinazione bit per bit dei flag di convalida del nome file che specifica il comportamento del localizzatore multimediale. I flag SFN_VALIDATEF_REPLACE e SFN_VALIDATEF_CHECK devono essere presenti oppure il metodo restituisce E_INVALIDARG.

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.

NotifyEventHandle

Handle per un evento. Il metodo segnala l'evento dopo aver completato la convalida.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

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

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 IAMTimeline

Codici di errore e di esito positivo