Condividi tramite


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