Méthode ISampleGrabber::GetConnectedMediaType

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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.]

Notes

[Déconseillé. Cette API peut être supprimée des versions ultérieures de Windows.]

 

La GetConnectedMediaType méthode récupère le type de média pour la connexion sur la broche d’entrée de l’exemple Grabber.

Syntaxe

HRESULT GetConnectedMediaType(
   AM_MEDIA_TYPE *pType
);

Paramètres

pType

Pointeur vers une structure AM_MEDIA_TYPE allouée par l’appelant.

Valeur renvoyée

Retourne l’une des valeurs suivantes.

Code de retour Description
E_POINTER
Argument pointeur NULL .
S_OK
Opération réussie.
VFW_E_NOT_CONNECTED
Le filtre n’est pas connecté.

 

Notes

Cette méthode copie le type de média dans la structure AM_MEDIA_TYPE spécifiée par pType. L’appelant doit libérer le bloc de format du type de média. Vous pouvez utiliser la fonction CoTaskMemFree ou la fonction FreeMediaType dans la bibliothèque de classe de base.

Notes

Le fichier d’en-tête Qedit.h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.

 

Notes

Pour obtenir Qedit.h, téléchargez la mise à jour Microsoft Windows SDK pour Windows Vista et .NET Framework 3.0. Qedit.h n’est pas disponible dans le Microsoft Windows SDK pour Windows 7 et .NET Framework 3.5 Service Pack 1.

 

Configuration requise

Condition requise Valeur
En-tête
Qedit.h
Bibliothèque
Strmiids.lib

Voir aussi

Utilisation de l’exemple Grabber

ISampleGrabber, interface