Méthode IMFMediaSink ::RemoveStreamSink (mfidl.h)
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 |
|
Ce récepteur de flux particulier ne peut pas être supprimé. |
|
Le numéro de flux n’est pas valide. |
|
Le récepteur multimédia n’a pas été initialisé. |
|
La méthode Shutdown du récepteur multimédia a été appelée. |
|
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 |