IMFSourceReader::GetPresentationAttribute-Methode (mfreadwrite.h)

Artikel
03/06/2024

Ruft ein Attribut aus der zugrunde liegenden Medienquelle ab.

Syntax

HRESULT GetPresentationAttribute(
  [in]  DWORD       dwStreamIndex,
  [in]  REFGUID     guidAttribute,
  [out] PROPVARIANT *pvarAttribute
);

Parameter

[in] dwStreamIndex

Der abzufragende Stream oder das abzufragende Objekt. Der Wert kann einer der folgenden Werte sein.

Wert	Bedeutung
0–0xFFFFFFFB	Der nullbasierte Index eines Datenstroms.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Der erste Videostream.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Der erste Audiodatenstrom.
MF_SOURCE_READER_MEDIASOURCE 0xFFFFFFFF	Die Medienquelle.

[in] guidAttribute

Eine GUID, die das abzurufende Attribut identifiziert. Wenn der dwStreamIndex-Parametergleich MF_SOURCE_READER_MEDIASOURCE ist, kann guidAttribute eine der folgenden Angaben angeben:

Ein Präsentationsdeskriptor-Attribut. Eine Liste der Werte finden Sie unter Presentation Descriptor Attributes.For a list of values, see Presentation Descriptor Attributes.
MF_SOURCE_READER_MEDIASOURCE_CHARACTERISTICS. Verwenden Sie diesen Wert, um Merkmaleflags aus der Medienquelle abzurufen.

Wenn der dwStreamIndex-Parameter andernfalls einen Stream angibt, gibt guidAttribute ein Streamdeskriptorattribut an. Eine Liste der Werte finden Sie unter Stream Deskriptorattribute.

[out] pvarAttribute

Ein Zeiger auf einen PROPVARIANT , der den Wert des Attributs empfängt. Rufen Sie die PropVariantClear-Funktion auf, um PROPVARIANT frei zu geben.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Schnittstelle ist unter Windows Vista verfügbar, wenn das Plattformupdate-Supplement für Windows Vista installiert ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Ergänzung zu Windows 7, Windows Vista und Plattformupdates für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfreadwrite.h

Weitere Informationen

IMFSourceReader

Media Foundation-Attribute

Quellleser

Freigeben über