Método IMFMediaSink::RemoveStreamSink (mfidl.h)
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 |
|---|---|
|
O método foi bem-sucedido. |
|
Esse coletor de fluxo específico não pode ser removido. |
|
O número do fluxo não é válido. |
|
O coletor de mídia não foi inicializado. |
|
O método Shutdown do coletor de mídia foi chamado. |
|
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 |