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

  • Article

Supprime un récepteur de flux du récepteur multimédia.

Syntaxe

HRESULT RemoveStreamSink(
  [in] DWORD dwStreamSinkIdentifier
);

Paramètres

[in] dwStreamSinkIdentifier

Identificateur du flux à supprimer. L’identificateur de flux est défini lorsque vous appelez IMFMediaSink ::AddStreamSink pour ajouter le récepteur de flux.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
E_INVALIDARG
 Ce récepteur de flux particulier ne peut pas être supprimé.
MF_E_INVALIDSTREAMNUMBER
 Le numéro de flux n’est pas valide.
MF_E_NOT_INITIALIZED
 Le récepteur multimédia n’a pas été initialisé.
MF_E_SHUTDOWN
 La méthode Shutdown du récepteur multimédia a été appelée.
MF_E_STREAMSINKS_FIXED
 Ce récepteur multimédia a un ensemble fixe de récepteurs de flux. Stream récepteurs ne peuvent pas être supprimés.

Remarques

Une fois cette méthode appelée, l’objet récepteur de flux correspondant n’est plus valide. Les méthodes IMFMediaSink ::GetStreamSinkByIndex et IMFMediaSink ::GetStreamSinkById ne retournent plus ce récepteur de flux. Vous pouvez réutiliser l’identificateur de flux si vous ajoutez un autre flux (en appelant AddStreamSink).

Tous les récepteurs multimédias ne prennent pas en charge cette méthode. Si le récepteur multimédia ne prend pas en charge cette méthode, la méthode IMFMediaSink ::GetCharacteristics retourne l’indicateur MEDIASINK_FIXED_STREAMS.

Dans certains cas, le récepteur multimédia prend en charge cette méthode, mais n’autorise pas la suppression de tous les récepteurs de flux. (Par exemple, il peut ne pas autoriser la suppression du flux 0.)

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête mfidl.h
Bibliothèque Mfuuid.lib

Voir aussi

IMFMediaSink

Récepteurs multimédias