Bagikan melalui

IMFCaptureSink::Metode AddStream (mfcaptureengine.h)

  • Artikel

Menyambungkan aliran dari sumber pengambilan ke sink tangkapan ini.

Sintaks

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

Parameter

[in] dwSourceStreamIndex

Aliran sumber yang akan disambungkan. Nilainya bisa salah satu dari yang berikut ini.

Nilai Makna
0–0xFFFFFFFB
 Indeks aliran berbasis nol. Untuk mendapatkan jumlah aliran, panggil IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 Aliran gambar pertama.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 Streaming video pertama.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 Aliran audio pertama.

[in] pMediaType

Penunjuk IMFMediaType yang menentukan format aliran output yang diinginkan. Detail format akan bergantung pada sink pengambilan.

  • Sink foto: Format gambar diam yang kompatibel dengan Komponen Pencitraan Windows (WIC).
  • Pratinjau sink: Format audio atau video yang tidak dikompresi.
  • Rekam sink: Format audio atau video yang akan ditulis ke file output.

[in] pAttributes

Penunjuk ke antarmuka IMFAttributes . Untuk aliran terkompresi, Anda dapat menggunakan parameter ini untuk mengonfigurasi encoder. Parameter ini juga bisa NULL.

Untuk sink pratinjau, atur parameter ini ke NULL.

[out] pdwSinkStreamIndex

Menerima indeks aliran baru pada sink pengambilan. Perhatikan bahwa indeks ini tidak akan selalu cocok dengan nilai dwSourceStreamIndex.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
 Berhasil.
MF_E_INVALIDMEDIATYPE
 Format yang ditentukan dalam pMediaType tidak valid untuk sink pengambilan ini.
MF_E_INVALIDSTREAMNUMBER
 Parameter dwSourceStreamIndex tidak valid, atau aliran sumber yang ditentukan sudah tersambung ke sink ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header mfcaptureengine.h

Lihat juga

IMFCaptureSink