IMixerPinConfig-Schnittstelle (mpconfig.h)
[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.]
Die IMixerPinConfig Schnittstelle wird auf den Eingabenadeln des Overlay Mixer-Filters verfügbar gemacht und enthält Methoden, die Videostreams auf verschiedene Weise bearbeiten. Der Überlagerungsmixer enthält mehrere Eingabepins, die dynamisch erstellt werden, wenn Videoeingabestreams hinzugefügt werden. Der Videostream auf dem ersten Pin wird als primärer Datenstrom bezeichnet, und nachfolgende Datenströme werden als sekundäre Datenströme bezeichnet.
Verwenden Sie diese Schnittstelle, um die Parameter zu bearbeiten, die beim Mischen verschiedener Videostreams beteiligt sind. Zu diesen Parametern gehören das Abrufen und Festlegen von Position, Z-Reihenfolge, Blending- und Transparenzebenen, Seitenverhältniskorrektur und Farbtasten von Streams.
Wenn Sie die Position von Videostreams im Anzeigefenster festlegen, ist die relative Standardposition aller sekundären Datenströme {0, 0, 0, 0}. Verwenden Sie daher die IMixerPinConfig::SetRelativePosition-Methode für sekundäre Datenströme, um sicherzustellen, dass alle Videostreams ordnungsgemäß platziert werden.
Anwendungen verwenden diese Schnittstelle zum Abrufen und Festlegen von Attributen beim Mischen mehrerer Videostreams.
Vererbung
Die IMixerPinConfig-Schnittstelle erbt von der IUnknown-Schnittstelle . IMixerPinConfig verfügt auch über folgende Membertypen:
Methoden
Die IMixerPinConfig-Schnittstelle verfügt über diese Methoden.
| IMixerPinConfig::GetAspectRatioMode Die GetAspectRatioMode-Methode ruft den Korrekturmodus für das Seitenverhältnis zum Ändern der Fenstergröße ab. |
| IMixerPinConfig::GetBlendingParameter Die GetBlendingParameter-Methode ruft den Wert des Blendingparameters ab, der definiert, wie ein sekundärer Datenstrom mit einem primären Datenstrom gemischt wird. |
| IMixerPinConfig::GetColorKey Die GetColorKey-Methode ruft den Farbschlüssel ab, der von einem Videostream verwendet wird. |
| IMixerPinConfig::GetRelativePosition Die GetRelativePosition-Methode ruft die Position des Datenstroms im Anzeigefenster ab. |
| IMixerPinConfig::GetStreamTransparent Die GetStreamTransparent-Methode bestimmt, ob ein Stream transparent ist. |
| IMixerPinConfig::GetZOrder Die GetZOrder-Methode ruft die Z-Reihenfolge eines bestimmten Videodatenstroms ab. |
| IMixerPinConfig::SetAspectRatioMode Die SetAspectRatioMode-Methode legt den Korrekturmodus für das Seitenverhältnis für die Fenstergröße fest. |
| IMixerPinConfig::SetBlendingParameter Die SetBlendingParameter-Methode legt den Blendingparameter fest, der definiert, wie ein sekundärer Datenstrom mit einem primären Datenstrom gemischt wird. |
| IMixerPinConfig::SetColorKey Die SetColorKey-Methode legt den Farbschlüssel fest, der von einem Videostream verwendet wird. |
| IMixerPinConfig::SetRelativePosition Die SetRelativePosition-Methode legt die Position des Datenstroms im Anzeigefenster fest. |
| IMixerPinConfig::SetStreamTransparent Die SetStreamTransparent-Methode legt den Stream auf transparent fest. |
| IMixerPinConfig::SetZOrder Die SetZOrder-Methode legt die Z-Reihenfolge eines bestimmten Videodatenstroms fest. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mpconfig.h |