Método IMFMediaSink::AddStreamSink (mfidl.h)

  • Artigo

Adiciona um novo coletor de fluxo ao coletor de mídia.

Sintaxe

HRESULT AddStreamSink(
  [in]  DWORD         dwStreamSinkIdentifier,
  [in]  IMFMediaType  *pMediaType,
  [out] IMFStreamSink **ppStreamSink
);

Parâmetros

[in] dwStreamSinkIdentifier

Identificador para o novo fluxo. O valor é arbitrário, mas deve ser exclusivo.

[in] pMediaType

Ponteiro para a interface IMFMediaType , especificando o tipo de mídia para o fluxo. Este parâmetro pode ser NULL.

[out] ppStreamSink

Recebe um ponteiro para a interface IMFStreamSink do novo coletor de fluxo. O chamador deve liberar a interface.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
MF_E_INVALIDSTREAMNUMBER
 O identificador de fluxo especificado não é válido.
MF_E_SHUTDOWN
 O método Shutdown do coletor de mídia foi chamado.
MF_E_STREAMSINK_EXISTS
 Já existe um coletor de fluxo com o mesmo identificador de fluxo.
MF_E_STREAMSINKS_FIXED
 Esse coletor de mídia tem um conjunto fixo de coletores de fluxo. Novos coletores de fluxo não podem ser adicionados.

Comentários

Nem todos os coletores de mídia dão suporte a esse método. Se o coletor de mídia não der suporte a esse método, o método IMFMediaSink::GetCharacteristics retornará o sinalizador MEDIASINK_FIXED_STREAMS.

Se pMediaType for NULL, use a interface IMFMediaTypeHandler para definir o tipo de mídia. Chame IMFStreamSink::GetMediaTypeHandler para obter um ponteiro para a interface.

Requisitos

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mfuuid.lib

Confira também

IMFMediaSink

Coletores de Mídia