Método IMFCaptureSink::AddStream (mfcaptureengine.h)

Artigo
08/24/2023

Conecta um fluxo da origem da captura a esse coletor de captura.

Sintaxe

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

Parâmetros

[in] dwSourceStreamIndex

O fluxo de origem a ser conectado. O valor pode ser qualquer um dos seguintes.

Valor	Significado
0 a 0xFFFFFFFB	O índice baseado em zero de um fluxo. Para obter o número de fluxos, chame IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM 0xFFFFFFFB	O primeiro fluxo de imagem.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM 0xFFFFFFFC	O primeiro fluxo de vídeo.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM 0xFFFFFFFD	O primeiro fluxo de áudio.

[in] pMediaType

Um ponteiro IMFMediaType que especifica o formato desejado do fluxo de saída. Os detalhes do formato dependerão do coletor de captura.

Coletor de fotos: um formato de imagem ainda compatível com o WIC (Componente de Imagem do Windows ).
Coletor de visualização: um formato de áudio ou vídeo descompactado.
Coletor de gravação: o formato de áudio ou vídeo que será gravado no arquivo de saída.

[in] pAttributes

Um ponteiro para a interface IMFAttributes . Para fluxos compactados, você pode usar esse parâmetro para configurar o codificador. Esse parâmetro também pode ser NULL.

Para o coletor de visualização, defina esse parâmetro como NULL.

[out] pdwSinkStreamIndex

Recebe o índice do novo fluxo no coletor de captura. Observe que esse índice não corresponderá necessariamente ao valor de dwSourceStreamIndex.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
MF_E_INVALIDMEDIATYPE	O formato especificado em pMediaType não é válido para este coletor de captura.
MF_E_INVALIDSTREAMNUMBER	O parâmetro dwSourceStreamIndex é inválido ou o fluxo de origem especificado já estava conectado a esse coletor.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfcaptureengine.h

Confira também

IMFCaptureSink

Compartilhar via