Méthode CSourceStream.GetMediaType (Source.h)
[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]
La GetMediaType méthode récupère un type de média préféré.
Syntaxe
virtual HRESULT GetMediaType(
CMediaType *pMediaType
);
Paramètres
-
pMediaType
-
Pointeur vers un objet CMediaType qui reçoit le type de média.
Valeur renvoyée
Retourne l’une des valeurs HRESULT indiquées dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
Index hors plage. |
|
Index inférieur à zéro. |
|
Erreur inattendue. |
Notes
Il existe deux versions de cette méthode. Une version remplace la méthode CBasePin::GetMediaType et prend une valeur d’index comme paramètre. L’autre version étant conçue pour récupérer un seul type de média, elle n’a pas le paramètre d’index.
La méthode à paramètre unique retourne E_UNEXPECTED. La méthode à deux paramètres vérifie que le paramètre iPosition est égal à zéro, puis appelle la version à paramètre unique. Selon le nombre de types de supports pris en charge par l’épingle, vous devez remplacer l’une des méthodes suivantes :
- Si l’épingle prend en charge un seul type de média, remplacez la version à paramètre unique. Renseignez le type de média pris en charge par l’épingle.
- Si l’épingle prend en charge plusieurs types de média, remplacez la version à deux paramètres. Remplacez également la méthode CSourceStream::CheckMediaType .
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|