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

  • Artigo

Remove um coletor de fluxo do coletor de mídia.

Sintaxe

HRESULT RemoveStreamSink(
  [in] DWORD dwStreamSinkIdentifier
);

Parâmetros

[in] dwStreamSinkIdentifier

Identificador do fluxo a ser removido. O identificador de fluxo é definido quando você chama IMFMediaSink::AddStreamSink para adicionar o coletor de fluxo.

Retornar valor

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.
E_INVALIDARG
 Esse coletor de fluxo específico não pode ser removido.
MF_E_INVALIDSTREAMNUMBER
 O número do fluxo não é válido.
MF_E_NOT_INITIALIZED
 O coletor de mídia não foi inicializado.
MF_E_SHUTDOWN
 O método Shutdown do coletor de mídia foi chamado.
MF_E_STREAMSINKS_FIXED
 Esse coletor de mídia tem um conjunto fixo de coletores de fluxo. Stream coletores não podem ser removidos.

Comentários

Depois que esse método é chamado, o objeto do coletor de fluxo correspondente não é mais válido. Os métodos IMFMediaSink::GetStreamSinkByIndex e IMFMediaSink::GetStreamSinkById não retornarão mais esse coletor de fluxo. Você poderá reutilize o identificador de fluxo se adicionar outro fluxo (chamando AddStreamSink).

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.

Em alguns casos, o coletor de mídia dá suporte a esse método, mas não permite que todos os coletores de fluxo sejam removidos. (Por exemplo, ele pode não permitir que o fluxo 0 seja removido.)

Requisitos

Requisito Valor
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