Condividi tramite

Impostazione delle proprietà nelle origini

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché 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 può essere modificata o non disponibile in futuro.]

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

  • Ora di inizio e arresto, rispetto al resto della sequenza temporale. Chiamare il metodo IAMTimelineObj::SetStartStop . Non impostare tempi di sovrapposizione sugli oggetti di origine all'interno della stessa traccia oppure causerà un comportamento non definito.
  • File multimediale da usare come clip di origine. Chiamare IAMTimelineSrc::SetMediaName.
  • Ora di inizio e arresto del supporto rispetto al file di origine originale. Chiamare il metodo IAMTimelineSrc::SetMediaTimes . Eccezione: se l'origine è un'immagine ancora, non specificare i tempi multimediali. Per altre informazioni sui tempi multimediali, vedere Time in DirectShow Editing Services.

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à di estensione specifica come 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 conservare le proporzioni. In alternativa, DES può ritagliare un'immagine o creare una casella di posta. 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 di supporti, come descritto in Uso del rilevatore di supporti. Chiamare il metodo IAMTimelineSrc::SetMediaLength per specificare la durata del file.
  • Numero di flusso. Per impostazione predefinita, un oggetto di origine usa il primo flusso nel file che corrisponde al tipo di supporto del gruppo padre. 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.

Uso delle origini