Metodo IMFMediaSink::RemoveStreamSink (mfidl.h)

Rimuove un sink di flusso dal sink multimediale.

Sintassi

HRESULT RemoveStreamSink(
  [in] DWORD dwStreamSinkIdentifier
);

Parametri

[in] dwStreamSinkIdentifier

Identificatore del flusso da rimuovere. L'identificatore del flusso viene definito quando si chiama IMFMediaSink::AddStreamSink per aggiungere il sink del flusso.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Impossibile rimuovere questo sink di flusso specifico.
MF_E_INVALIDSTREAMNUMBER	Il numero di flusso non è valido.
MF_E_NOT_INITIALIZED	Il sink multimediale non è stato inizializzato.
MF_E_SHUTDOWN	È stato chiamato il metodo Shutdown del sink multimediale.
MF_E_STREAMSINKS_FIXED	Questo sink multimediale ha un set fisso di sink di flusso. Stream sink non possono essere rimossi.

Commenti

Dopo aver chiamato questo metodo, l'oggetto sink del flusso corrispondente non è più valido. I metodi IMFMediaSink::GetStreamSinkByIndex e IMFMediaSink::GetStreamSinkById non restituiranno più tale sink di flusso. È possibile riutilizzare l'identificatore del flusso se si aggiunge un altro flusso (chiamando AddStreamSink).

Non tutti i sink multimediali supportano questo metodo. Se il sink multimediale non supporta questo metodo, il metodo IMFMediaSink::GetCharacteristics restituisce il flag MEDIASINK_FIXED_STREAMS.

In alcuni casi, il sink multimediale supporta questo metodo, ma non consente la rimozione di ogni sink di flusso. Ad esempio, potrebbe non consentire la rimozione del flusso 0.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfidl.h
Libreria	Mfuuid.lib

Vedi anche

IMFMediaSink

Sink multimediali