Festlegen von Eigenschaften für Quellen
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
[Diese API wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr verfügbar sein.]
Wenn Sie ein neues Quellobjekt erstellen, müssen Sie einige Eigenschaften festlegen, und andere können Sie optional festlegen. Sie müssen die folgenden Eigenschaften festlegen.
- Die Start- und Stoppzeiten relativ zum Rest der Zeitleiste. Rufen Sie die IAMTimelineObj::SetStartStop-Methode auf. Legen Sie keine überlappenden Zeiten für Quellobjekte innerhalb derselben Spur fest, da sonst nicht definiertes Verhalten verursacht wird.
- Die Mediendatei, die als Quellclip verwendet werden soll. Rufen Sie IAMTimelineSrc::SetMediaName auf.
- Die Start- und Endzeiten der Medien relativ zur ursprünglichen Quelldatei. Rufen Sie die IAMTimelineSrc::SetMediaTimes-Methode auf . Ausnahme: Wenn es sich bei der Quelle um ein Standbild handelt, geben Sie die Medienzeiten nicht an. Weitere Informationen zu Medienzeiten finden Sie unter Time in DirectShow Editing Services.
Ein Quellobjekt erbt seinen Medientyp von der übergeordneten Gruppe, sodass es nicht erforderlich ist, einen Medientyp anzugeben.
Zu den optionalen Eigenschaften gehören die folgenden:
- Der Stretch-Modus. Der Stretch-Modus gibt an, wie Microsoft® DirectShow® Editing Services (DES) eine Quelle rendert, deren Größe nicht mit den Ausgabedimensionen übereinstimmt. Standardmäßig streckt DES ein Bild, ohne das Seitenverhältnis beizubehalten. Alternativ kann DES ein Bild zuschneiden oder einen Briefkasten erstellen. Rufen Sie die IAMTimelineSrc::SetStretchMode-Methode auf, um den Stretchmodus anzugeben.
- Die Dauer der Quelldatei. Wenn Sie diese Eigenschaft festlegen, bevor Sie die Medienzeiten festlegen, überprüft DES die Medienstoppzeit und schneidet die Stoppzeit ab, wenn sie die Dateidauer überschreitet. Dies kann dazu beitragen, Renderingfehler später zu vermeiden. Sie können die Dauer der Datei mithilfe der Medienerkennung abrufen, wie unter Verwenden der Medienerkennung beschrieben. Rufen Sie die IAMTimelineSrc::SetMediaLength-Methode auf, um die Dateidauer anzugeben.
- Die Streamnummer. Standardmäßig verwendet ein Quellobjekt den ersten Stream in der Datei, der dem Medientyp der übergeordneten Gruppe entspricht. Wenn eine Datei zwei oder mehr Streams desselben Medientyps enthält, wählen Sie den zu verwendenden Stream aus, indem Sie IAMTimelineSrc::SetStreamNumber aufrufen. Sie können die Medienerkennung verwenden, um die Anzahl der Streams zu ermitteln.
Zugehörige Themen