IMediaDet::get_StreamType-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die get_StreamType -Methode ruft den globalen eindeutigen Bezeichner (GUID) für den Medientyp des aktuellen Datenstroms ab.

Syntax

HRESULT get_StreamType(
  [out, retval] GUID *pVal
);

Parameter

pVal [out, retval]

Empfängt die Haupttyp-GUID für den Medientyp.

Rückgabewert

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

Bemerkungen

Diese Methode ruft das Haupttypelement der AM_MEDIA_TYPE-Struktur ab. Die AM_MEDIA_TYPE-Struktur beschreibt das Format des Datenstroms, und das Haupttypelement ist eine GUID, die die allgemeine Kategorie angibt, z. B. Audio oder Video. Für einen Videostream wird die GUID MEDIATYPE_Video. Für Audio ist es MEDIATYPE_Audio. Um die gesamte AM_MEDIA_TYPE-Struktur abzurufen, rufen Sie die IMediaDet::get_StreamMediaType-Methode auf.

Legen Sie vor dem Aufrufen dieser Methode den Dateinamen und den Stream fest, indem Sie IMediaDet::p ut_Filename und IMediaDet::p ut_CurrentStream aufrufen.

Wenn sich der Mediendetektor im Bitmap-Grabmodus befindet, gibt diese Methode E_INVALIDARG zurück. Weitere Informationen finden Sie unter IMediaDet::EnterBitmapGrabMode.

Anforderungen

Siehe auch

IMediaDet-Schnittstelle

Fehler- und Erfolgscodes