IAMStreamSelect::Info-Methode (strmif.h)

Artikel
07/28/2023

[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 Info -Methode ruft Informationen zu einem bestimmten Datenstrom ab.

Syntax

HRESULT Info(
  [in]  long          lIndex,
  [out] AM_MEDIA_TYPE **ppmt,
  [out] DWORD         *pdwFlags,
  [out] LCID          *plcid,
  [out] DWORD         *pdwGroup,
  [out] LPWSTR        *ppszName,
  [out] IUnknown      **ppObject,
  [out] IUnknown      **ppUnk
);

Parameter

[in] lIndex

Nullbasierter Index des Datenstroms.

[out] ppmt

Adresse einer Variablen, die einen Zeiger auf den Medientyp des Datenstroms empfängt. Dieser Parameter ist optional und kann NULL sein. Wenn der Wert ungleich NULL ist, gibt die Methode einen Zeiger auf eine AM_MEDIA_TYPE-Struktur zurück. Der Aufrufer muss die Struktur einschließlich des Formatblocks löschen. (Sie können die DeleteMediaType-Funktion aus der DirectShow-Basisklassenbibliothek verwenden.)

[out] pdwFlags

Zeiger auf eine Variable, die einen der folgenden Werte empfängt:

Wert	BESCHREIBUNG
Null	Dieser Stream ist deaktiviert.
AMSTREAMSELECTINFO_ENABLED	Der Stream ist aktiviert, und andere in dieser Gruppe sind möglicherweise ebenfalls aktiviert.
AMSTREAMSELECTINFO_EXCLUSIVE	Dieser Stream ist der einzige aktivierte Stream in der Gruppe.

Dieser Parameter ist optional und kann NULL sein.

[out] plcid

Zeiger auf eine Variable, die einen LCID-Wert (Locale Context) empfängt. Wenn der Stream einem bestimmten Gebietsschema zugeordnet ist, wird die LCID in dieser Variablen zurückgegeben. Andernfalls empfängt die Variable den Wert 0. Dieser Parameter ist optional und kann NULL sein.

[out] pdwGroup

Zeiger auf eine Variable, die die logische Gruppe empfängt, der der Stream zugeordnet ist. Dieser Parameter ist optional und kann NULL sein.

[out] ppszName

Adresse einer Variablen, die einen Zeiger auf den Streamnamen empfängt. Der Aufrufer muss die zurückgegebene Zeichenfolge durch Aufrufen der CoTaskMemFree-Funktion freigeben. Dieser Parameter ist optional und kann NULL sein.

[out] ppObject

Adresse einer Variablen, die einen IUnknown-Schnittstellenzeiger empfängt. Die -Methode gibt möglicherweise einen Zeiger auf eine Pin oder einen Filter zurück, der dem Datenstrom zugeordnet ist, oder sie gibt den Wert NULL zurück. Wenn die Methode einen Wert ungleich NULL zurückgibt, muss der Aufrufer den IUnknown-Zeiger freigeben.

Durch aufrufen der IAMStreamSelect::Enable-Methode wird das von dieser Methode zurückgegebene Objekt möglicherweise ungültig.

Dieser Parameter ist optional und kann NULL sein.

Die Parserfilter MPEG-1 Stream Splitter, MPEG-2 Splitter und SAMI (CC) geben einen Zeiger auf die dem ausgewählten Datenstrom zugeordnete Pin zurück.

[out] ppUnk

Adresse einer Variablen, die einen IUnknown-Schnittstellenzeiger empfängt. Die -Methode gibt möglicherweise einen Zeiger auf eine Schnittstelle zurück, die für den Datenstrom spezifisch ist, oder sie gibt den Wert NULL zurück. Wenn die Methode einen Wert ungleich NULL zurückgibt, muss der Aufrufer den IUnknown-Zeiger freigeben. Dieser Parameter ist optional und kann NULL sein.

Die Filter MPEG-1 Stream Splitter, MPEG-2 Splitter und SAMI (CC) geben alle den Wert NULL zurück. Filter von Drittanbietern geben möglicherweise einen Zeiger auf eine benutzerdefinierte Filterschnittstelle zurück.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
E_FAIL	Fehler.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
S_FALSE	Der Index liegt außerhalb des gültigen Bereichs.
S_OK	Erfolg.

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	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IAMStreamSelect-Schnittstelle

Freigeben über