IMFMediaSink::GetCharacteristics-Methode (mfidl.h)

  • Artikel

Ruft die Merkmale der Mediensenke ab.

Syntax

HRESULT GetCharacteristics(
  [out] DWORD *pdwCharacteristics
);

Parameter

[out] pdwCharacteristics

Empfängt ein bitweises OR mit 0 oder mehr Flags. Die folgenden Flags sind definiert:

Wert Bedeutung
MEDIASINK_FIXED_STREAMS
0x00000001
 Die Mediensenke verfügt über eine feste Anzahl von Streams. Die Methoden IMFMediaSink::AddStreamSink und IMFMediaSink::RemoveStreamSink werden nicht unterstützt. Dieses Flag ist ein Hinweis an die Anwendung.
MEDIASINK_CANNOT_MATCH_CLOCK
0x00000002
 Die Mediensenke kann keine Raten mit einer externen Uhr abgleichen.

Um optimale Ergebnisse zu erzielen, sollte diese Mediensenke als Zeitquelle für die Präsentationsuhr verwendet werden. Wenn eine andere Zeitquelle verwendet wird, kann die Mediensenke die Raten nicht mit der Uhr abgleichen, was zu schlechten Ergebnissen führt (z. B. Störungen).

Dieses Flag sollte sparsam verwendet werden, da es die Konfiguration der Pipeline einschränkt.

Weitere Informationen zur Präsentationsuhr finden Sie unter Präsentationsuhr.
MEDIASINK_RATELESS
0x00000004
 Die Mediensenke ist ohne Geschwindigkeit. Sie nutzt Beispiele so schnell wie möglich und synchronisiert sich nicht mit einer Präsentationsuhr.

Die meisten Archivierungssenken sind ohne Geschwindigkeit.
MEDIASINK_CLOCK_REQUIRED
0x00000008
 Die Mediensenke erfordert eine Präsentationsuhr. Die Präsentationsuhr wird durch Aufrufen der IMFMediaSink::SetPresentationClock-Methode der Mediensenke festgelegt.

Dieses Flag ist veraltet, da alle Mediensenken die SetPresentationClock-Methode unterstützen müssen, auch wenn die Mediensenke die Uhr ignoriert (wie in einer ratelosen Mediensenke).
MEDIASINK_CAN_PREROLL
0x00000010
 Die Mediensenke kann Vorabrollbeispiele akzeptieren, bevor die Präsentationsuhr beginnt. Die Mediensenke macht die IMFMediaSinkPreroll-Schnittstelle verfügbar.
MEDIASINK_REQUIRE_REFERENCE_MEDIATYPE
0x00000020
 Die erste Streamsenke (Index 0) ist ein Referenzdatenstrom. Der Verweisdatenstrom muss über einen Medientyp verfügen, bevor die Medientypen für die anderen Datenstromsenken festgelegt werden können.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_SHUTDOWN
 Die Shutdown-Methode der Mediensenke wurde aufgerufen.

Hinweise

Die Eigenschaften einer Mediensenke sind während der gesamten Lebensdauer der Senke festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFMediaSink

Mediensenken