Partilhar via


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

Conecta um fluxo da fonte de 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.

Value Meaning
0–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 não compactado.
  • Coletor de registro: 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 necessariamente corresponderá ao valor de dwSourceStreamIndex.

Valor de retorno

Esse método pode retornar um desses valores.

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

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2012 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header mfcaptureengine.h

Consulte também

IMFCaptureSink