IMFCaptureSink::AddStream-Methode (mfcaptureengine.h)

Artikel
08/24/2023

Verbindet einen Stream aus der Erfassungsquelle mit dieser Erfassungssenke.

Syntax

HRESULT AddStream(
  [in]  DWORD         dwSourceStreamIndex,
  [in]  IMFMediaType  *pMediaType,
  [in]  IMFAttributes *pAttributes,
  [out] DWORD         *pdwSinkStreamIndex
);

Parameter

[in] dwSourceStreamIndex

Der Quelldatenstrom, der eine Verbindung herstellt. Der Wert kann einer der folgenden Werte sein.

Wert	Bedeutung
0–0xFFFFFFFB	Der nullbasierte Index eines Datenstroms. Rufen Sie ZUM Abrufen der Anzahl der Streams IMFCaptureSource::GetDeviceStreamCount auf.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM 0xFFFFFFFB	Der erste Bilddatenstrom.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM 0xFFFFFFFC	Der erste Videostream.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM 0xFFFFFFFD	Der erste Audiodatenstrom.

[in] pMediaType

Ein IMFMediaType-Zeiger , der das gewünschte Format des Ausgabedatenstroms angibt. Die Details des Formats hängen von der Erfassungssenke ab.

Fotosenke: Ein Mit windows Imaging Component (WIC) kompatibles Bildformat.
Vorschausenke: Ein unkomprimiertes Audio- oder Videoformat.
Aufzeichnungssenke: Das Audio- oder Videoformat, das in die Ausgabedatei geschrieben wird.

[in] pAttributes

Ein Zeiger auf die IMFAttributes-Schnittstelle . Für komprimierte Datenströme können Sie diesen Parameter verwenden, um den Encoder zu konfigurieren. Dieser Parameter kann auch NULL sein.

Legen Sie für die Vorschausenke diesen Parameter auf NULL fest.

[out] pdwSinkStreamIndex

Empfängt den Index des neuen Datenstroms in der Erfassungssenke. Beachten Sie, dass dieser Index nicht unbedingt mit dem Wert von dwSourceStreamIndex übereinstimmt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
MF_E_INVALIDMEDIATYPE	Das in pMediaType angegebene Format ist für diese Erfassungssenke ungültig.
MF_E_INVALIDSTREAMNUMBER	Der dwSourceStreamIndex-Parameter ist ungültig, oder der angegebene Quellstream war bereits mit dieser Senke verbunden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mfcaptureengine.h

Weitere Informationen

IMFCaptureSink

Freigeben über