IMFPresentationDescriptor::GetStreamDescriptorByIndex-Methode (mfidl.h)

Ruft einen Streamdeskriptor für einen Stream in der Präsentation ab. Die Streambeschreibung enthält Informationen zum Stream.

Syntax

HRESULT GetStreamDescriptorByIndex(
  [in]  DWORD               dwIndex,
  [out] BOOL                *pfSelected,
  [out] IMFStreamDescriptor **ppDescriptor
);

Parameter

[in] dwIndex

Nullbasierter Index des Streams. Um die Anzahl der Streams in der Präsentation zu ermitteln, rufen Sie die IMFPresentationDescriptor::GetStreamDescriptorCount-Methode auf.

[out] pfSelected

Empfängt einen booleschen Wert. Der Wert ist TRUE , wenn der Stream derzeit ausgewählt ist, oder FALSE , wenn der Stream derzeit deaktiviert ist. Wenn ein Stream ausgewählt ist, generiert die Medienquelle Daten für diesen Stream, wenn IMFMediaSource::Start aufgerufen wird. Die Medienquelle generiert keine Daten für nicht ausgewählte Streams. Um einen Stream auszuwählen, rufen Sie IMFPresentationDescriptor::SelectStream auf. Um die Auswahl eines Streams aufzuheben, rufen Sie IMFPresentationDescriptor::D eselectStream auf.

[out] ppDescriptor

Empfängt einen Zeiger auf die IMFStreamDescriptor-Schnittstelle des Streamdeskriptors . Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

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

Hinweise

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

• Windows XP mit Service Pack 2 (SP2) und höher.
• Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition vom Oktober 2006) installiert.

Anforderungen

Weitere Informationen

IMFPresentationDescriptor

Präsentationsdeskriptoren