IMFMediaSink::GetCharacteristics-Methode (mfidl.h)
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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). |
|
Die Mediensenke kann Vorabrollbeispiele akzeptieren, bevor die Präsentationsuhr beginnt. Die Mediensenke macht die IMFMediaSinkPreroll-Schnittstelle verfügbar. |
|
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |