IMPEG2StreamIdMap::MapStreamId-Methode (strmif.h)

[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 MapStreamId -Methode ordnet die Stream-ID eines elementaren Datenstroms innerhalb eines MPEG-2-Programmstreams einem Medieninhaltstyp und Informationen zur Unterstreamfilterung zu.

Syntax

HRESULT MapStreamId(
  [in] ULONG ulStreamId,
  [in] DWORD MediaSampleContent,
  [in] ULONG ulSubstreamFilterValue,
  [in] int   iDataOffset
);

Parameter

[in] ulStreamId

Die Stream-ID des PES-Streams.

[in] MediaSampleContent

Gibt den Inhalt des Datenstroms an. Derzeit wird nur der Wert MPEG2_PROGRAM_ELEMENTARY_STREAM (definiert als 0x00000001 in axextend.idl) unterstützt.

[in] ulSubstreamFilterValue

Gibt an, welcher Teilstrom innerhalb dieses elementaren Datenstroms an den Downstreamdecoder übergeben werden soll. Nur das Byte mit niedriger Reihenfolge kann einen gültigen Filterwert enthalten. Wenn iDataOffset = 0 ist, wird dieser Parameter ignoriert.

[in] iDataOffset

Der Byteoffset in die Nutzlast, bei der der Teilstrom beginnt.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Wenn die Methode fehlschlägt, wird ein Fehlercode zurückgegeben. Wenn eine Stream-ID mit MEDIA_PROGRAM_STREAM_MAP, MEDIA_PROGRAM_DIRECTORY_PES_PACKET oder MEDIA_PROGRAM_PACK_HEADER versucht wird, gibt diese Methode E_NOTIMPL zurück.

Hinweise

Die von dieser Methode zugeordnete Stream-ID ist die Stream-ID im PES-Header. Die Substreamfilterung wird am häufigsten verwendet, um mehrere Kanäle für einen einzelnen Audiostream bereitzustellen.

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IMPEG2StreamIdMap-Schnittstelle