Metodo IMFCaptureSink::AddStream (mfcaptureengine.h)

Articolo
02/28/2024

Connette un flusso dall'origine di acquisizione a questo sink di acquisizione.

Sintassi

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

Parametri

[in] dwSourceStreamIndex

Flusso di origine da connettere. Il valore può essere uno dei seguenti.

Valore	Significato
0-0xFFFFFFFB	Indice in base zero di un flusso. Per ottenere il numero di flussi, chiamare IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM 0xFFFFFFFB	Primo flusso di immagini.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM 0xFFFFFFFC	Primo flusso video.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM 0xFFFFFFFD	Il primo flusso audio.

[in] pMediaType

Puntatore IMFMediaType che specifica il formato desiderato del flusso di output. I dettagli del formato dipendono dal sink di acquisizione.

Sink foto: un formato di immagine ancora compatibile con Windows Imaging Component (WIC).
Sink di anteprima: formato audio o video non compresso.
Sink di record: formato audio o video che verrà scritto nel file di output.

[in] pAttributes

Puntatore all'interfaccia IMFAttributes . Per i flussi compressi, è possibile usare questo parametro per configurare il codificatore. Questo parametro può anche essere NULL.

Per il sink di anteprima impostare questo parametro su NULL.

[out] pdwSinkStreamIndex

Riceve l'indice del nuovo flusso nel sink di acquisizione. Si noti che questo indice non corrisponde necessariamente al valore dwSourceStreamIndex.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
MF_E_INVALIDMEDIATYPE	Il formato specificato in pMediaType non è valido per questo sink di acquisizione.
MF_E_INVALIDSTREAMNUMBER	Il parametro dwSourceStreamIndex non è valido oppure il flusso di origine specificato è già stato connesso a questo sink.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfcaptureengine.h

Vedi anche

FMCaptureSink

Condividi tramite