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

  • Article

Obtient les caractéristiques du récepteur multimédia.

Syntaxe

HRESULT GetCharacteristics(
  [out] DWORD *pdwCharacteristics
);

Paramètres

[out] pdwCharacteristics

Reçoit un OR au niveau du bit de zéro ou plus d’indicateurs. Les indicateurs suivants sont définis :

Valeur Signification
MEDIASINK_FIXED_STREAMS
0x00000001
 Le récepteur multimédia a un nombre fixe de flux. Il ne prend pas en charge les méthodes IMFMediaSink ::AddStreamSink et IMFMediaSink ::RemoveStreamSink . Cet indicateur est un indicateur pour l’application.
MEDIASINK_CANNOT_MATCH_CLOCK
0x00000002
 Le récepteur multimédia ne peut pas faire correspondre les taux à une horloge externe.

Pour de meilleurs résultats, ce récepteur multimédia doit être utilisé comme source de temps pour l’horloge de présentation. Si une autre source de temps est utilisée, le récepteur multimédia ne peut pas faire correspondre les taux à l’horloge, avec des résultats médiocres (par exemple, un glitching).

Cet indicateur doit être utilisé avec parcimonie, car il limite la configuration du pipeline.

Pour plus d’informations sur l’horloge de la présentation, consultez Horloge de présentation.
MEDIASINK_RATELESS
0x00000004
 Le récepteur multimédia est sans débit. Il consomme des exemples aussi rapidement que possible et ne se synchronise pas avec une horloge de présentation.

La plupart des récepteurs d’archivage sont sans débit.
MEDIASINK_CLOCK_REQUIRED
0x00000008
 Le récepteur multimédia nécessite une horloge de présentation. L’horloge de présentation est définie en appelant la méthode IMFMediaSink ::SetPresentationClock du récepteur multimédia.

Cet indicateur est obsolète, car tous les récepteurs multimédias doivent prendre en charge la méthode SetPresentationClock , même si le récepteur multimédia ignore l’horloge (comme dans un récepteur multimédia sans débit).
MEDIASINK_CAN_PREROLL
0x00000010
 Le récepteur multimédia peut accepter des exemples de préroll avant le démarrage de l’horloge de la présentation. Le récepteur multimédia expose l’interface IMFMediaSinkPreroll .
MEDIASINK_REQUIRE_REFERENCE_MEDIATYPE
0x00000020
 Le premier récepteur de flux (index 0) est un flux de référence. Le flux de référence doit avoir un type de média pour que les types de média puissent être définis sur les autres récepteurs 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
MF_E_SHUTDOWN
 La méthode Shutdown du récepteur multimédia a été appelée.

Remarques

Les caractéristiques d’un récepteur multimédia sont fixes tout au long de la durée de vie du récepteur.

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