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

  • Artigo

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