IMFCaptureSink::AddStream-Methode (mfcaptureengine.h)

  • Artikel

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