Condividi tramite

Impostazione delle proprietà sulle origini

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEnginee Acquisizione audio/video in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente di utilizzare il nuovo codice con MediaPlayer, IMFMediaEngine e Acquisizione audio/video 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.

[Questa API non è supportata e potrebbe essere modificata o non disponibile in futuro.]

Quando si crea un nuovo oggetto di origine, sono necessarie alcune proprietà da impostare e altre è possibile impostare facoltativamente. È necessario impostare le proprietà seguenti.

  • Orari di inizio e arresto rispetto al resto della sequenza temporale. Chiamare il metodo IAMTimelineObj::SetStartStop. Non impostare tempi sovrapposti sugli oggetti di origine all'interno della stessa traccia, altrimenti potrebbe causare un comportamento indefinito.
  • File multimediale da utilizzare come clip di origine. Chiamare il IAMTimelineSrc::SetMediaName.
  • Ora di avvio e arresto del supporto rispetto al file di origine originale. Chiamare il metodo IAMTimelineSrc::SetMediaTimes. Eccezione: se l'origine è un'immagine fissa, non specificare i tempi multimediali. Per ulteriori informazioni sui tempi dei media, vedere Tempo nei servizi di modifica di DirectShow.

Un oggetto di origine eredita il tipo di supporto dal gruppo padre, pertanto non è necessario specificare un tipo di supporto.

Le proprietà facoltative includono quanto segue:

  • Modalità di estensione. La modalità stretch specifica il modo in cui Microsoft® DirectShow® Editing Services (DES) esegue il rendering di un'origine le cui dimensioni non corrispondono alle dimensioni di output. Per impostazione predefinita, DES estende un'immagine senza mantenere le proporzioni. In alternativa, DES può ritagliare un'immagine o creare una casella di lettere. Chiamare il metodo IAMTimelineSrc::SetStretchMode per specificare la modalità di estensione.
  • Durata del file di origine. Se si imposta questa proprietà prima di impostare i tempi multimediali, DES convalida il tempo di arresto multimediale e tronca il tempo di arresto se supera la durata del file. In questo modo è possibile evitare errori di rendering in un secondo momento. È possibile ottenere la durata del file usando il rilevatore multimediale, come descritto in Uso di Media Detector. Chiamare il metodo IAMTimelineSrc::SetMediaLength per specificare la durata del file.
  • Numero del flusso. Per impostazione predefinita, un oggetto di origine utilizza il primo flusso nel file che corrisponde al tipo di supporto del gruppo principale. Se un file contiene due o più flussi dello stesso tipo di supporto, selezionare il flusso da usare chiamando IAMTimelineSrc::SetStreamNumber. È possibile usare il rilevatore multimediale per trovare il numero di flussi.

Lavorare con le Fonti