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

  • Artículo

Quita un receptor de flujo del receptor de medios.

Sintaxis

HRESULT RemoveStreamSink(
  [in] DWORD dwStreamSinkIdentifier
);

Parámetros

[in] dwStreamSinkIdentifier

Identificador de la secuencia que se va a quitar. El identificador de flujo se define cuando se llama a IMFMediaSink::AddStreamSink para agregar el receptor de la secuencia.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_INVALIDARG
 No se puede quitar este receptor de secuencia determinado.
MF_E_INVALIDSTREAMNUMBER
 El número de secuencia no es válido.
MF_E_NOT_INITIALIZED
 El receptor de medios no se ha inicializado.
MF_E_SHUTDOWN
 Se ha llamado al método Shutdown del receptor multimedia.
MF_E_STREAMSINKS_FIXED
 Este receptor multimedia tiene un conjunto fijo de receptores de flujos. Stream receptores no se pueden quitar.

Comentarios

Después de llamar a este método, el objeto receptor de secuencia correspondiente ya no es válido. Los métodos IMFMediaSink::GetStreamSinkByIndex y IMFMediaSink::GetStreamSinkById ya no devolverán ese receptor de flujo. Puede volver a usar el identificador de secuencia si agrega otra secuencia (llamando a AddStreamSink).

No todos los receptores multimedia admiten este método. Si el receptor de medios no admite este método, el método IMFMediaSink::GetCharacteristics devuelve la marca de MEDIASINK_FIXED_STREAMS.

En algunos casos, el receptor de medios admite este método, pero no permite quitar todos los receptores de secuencias. (Por ejemplo, podría no permitir que se quite la secuencia 0).

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mfuuid.lib

Consulte también

IMFMediaSink

Receptores de medios