IAMExtTransport ::GetStatus, méthode (strmif.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 GetStatus méthode retourne des informations sur le status du transport.
Syntaxe
HRESULT GetStatus(
[in] long StatusItem,
[in, out] long *pValue
);
Paramètres
[in] StatusItem
Spécifie les informations status à récupérer. Pour plus d'informations, consultez la section Notes.
[in, out] pValue
Pointeur vers une variable qui spécifie ou reçoit un entier long , dont la signification dépend de la valeur de StatusItem. Pour plus d'informations, consultez la section Notes.
Valeur retournée
Lorsque cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .
Remarques
Le paramètre StatusItem est un indicateur qui spécifie les informations status à récupérer. La méthode retourne les informations dans le paramètre pValue . Tous les appareils ne prennent pas en charge chaque indicateur status. Les indicateurs suivants sont définis :
- ED_MODE : retourne le mode de transport actuel, par exemple pause ou lecture. Consultez IAMExtTransport ::p ut_Mode pour obtenir la liste des constantes qui définissent les modes de transport. Vous pouvez également définir StatusItem comme valeur égale à l’une de ces constantes, et pValue recevra la valeur OATRUE si le transport est actuellement dans ce mode, ou OAFALSE dans le cas contraire.
- ED_MEDIA_TYPE : indique le format du média pour ce transport. Retourne l’une des constantes suivantes.
Constant Description ED_MEDIA_VHS VHS ED_MEDIA_SVHS S-VHS ED_MEDIA_HI8 Hi-8 ED_MEDIA_UMATIC Umatic ED_MEDIA_DVC Bande DV (DVC) ED_MEDIA_1_INCH Bande de 1 pouce ED_MEDIA_D1 Format D1 ED_MEDIA_D2 Format D2 ED_MEDIA_D3 Format D3 ED_MEDIA_D5 Format D5 ED_MEDIA_DBETA Digital Betacam ED_MEDIA_BETA Betacam ED_MEDIA_8MM 8 millimètres ED_MEDIA_DDR Enregistreur de disque numérique ED_MEDIA_SX Betacam SX ED_MEDIA_OTHER Autres ED_MEDIA_CLV Laserdisc CLV (Constant Linear Velocity, ou « standard play ») ED_MEDIA_CAV Laserdisc CAV (Constant Angular Velocity, ou « lecture étendue ») - ED_LINK_MODE : renvoie OATRUE si les contrôles du transport sont liés aux méthodes Run, Stop et Pause du graphique de filtre, et oAFALSE dans le cas contraire. Pour plus d’informations, consultez IAMExtTransport ::p ut_Mode .
- ED_MEDIA_PRESENT : renvoie OATRUE si le support du transport est présent, ou OAFALSE dans le cas contraire.
- ED_MEDIA_LENGTH : retourne la longueur du média, en unités du format d’heure actuel (voir IAMExtTransport ::SetTransportBasicParameters).
- ED_MEDIA_TRACK_COUNT : retourne le nombre de pistes.
- ED_MEDIA_TRACK_LENGTH : retourne la longueur de la piste, en unités du format d’heure actuel.
- ED_MEDIA_SIDE : indique le côté du média actif.
| Constant | Description |
|---|---|
| ED_MODE_PLAY_SLOW_FWD_X | Lire l’avance lente non spécifiée. (Avance lente à la vitesse propre au fournisseur.) |
| ED_MODE_PLAY_FAST_FWD_X | Jouez une avance rapide non spécifiée. (Avance rapide à la vitesse propre au fournisseur.) |
| ED_MODE_PLAY_SLOW_REV_X | Lire l’inverse lent non spécifié. (Lecture lente et inversée à la vitesse propre au fournisseur.) |
| ED_MODE_PLAY_FAST_REV_X | Lire l’inverse rapide non spécifié. (Lecture inversée rapide à la vitesse propre au fournisseur.) |
| ED_MODE_STOP_START | Le transport est arrêté au début de la bande (ou d’un autre support de transport). |
| ED_MODE_STOP_END | Le transport est arrêté à la fin de la bande (ou d’un autre support de transport). |
| ED_MODE_STOP_EMERGENCY | Le transport s’est arrêté en raison de conditions inattendues ou pour éviter d’éventuels dommages au transport. |
Pour utiliser ces constantes, incluez le fichier d’en-tête Xprtdefs.h du SDK Windows.
Implémentation de DV
MSDV prend en charge les indicateurs de status suivants :
- ED_MODE : Consultez les remarques précédentes.
- ED_MEDIA_TYPE : retourne l’une des valeurs suivantes.
Constant Description ED_MEDIA_VHS Bande VHS. ED_MEDIA_DVC Bande DV. ED_MEDIA_UNKNOWN Type inconnu. ED_MEDIA_NOT_PRESENT Le transport est vide. - ED_DEV_REMOVED_HEVENT_GET. Retourne un handle à un événement. Le pilote signale l’événement si l’appareil est physiquement supprimé du système.
- ED_DEV_REMOVED_HEVENT_RELEASE. Libère le handle d’événement obtenu via l’indicateur ED_DEV_REMOVED_HEVENT_GET. Spécifiez l’adresse du handle dans le paramètre pValue.
- ED_MODE_CHANGE_NOTIFY. Retourne l’état de l’appareil dans pValue. Si la méthode retourne E_PENDING, un changement d’état est en attente. Vous pouvez utiliser l’indicateur ED_NOTIFY_HEVENT_GET pour obtenir une notification lorsque le changement d’état est terminé.
- ED_NOTIFY_HEVENT_GET. Retourne un handle à un événement. Le pilote signale l’événement lorsque l’appareil termine un changement de mode.
- ED_NOTIFY_HEVENT_RELEASE. Libère le handle d’événement obtenu via l’indicateur ED_NOTIFY_HEVENT_GET. Spécifiez l’adresse du handle dans le paramètre pValue.
Implémentation du caméscope MPEG
MSTape prend en charge un format multimédia supplémentaire pour l’indicateur ED_MEDIA_TYPE.
| Constant | Description |
|---|---|
| ED_MEDIA_NEO | Mini bande numérique pour le flux de transport MPEG-2 (D-VHS). |
Certains de ces indicateurs sont définis dans le fichier d’en-tête Xptrdefs.h.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | strmif.h (include Dshow.h) |
| Bibliothèque | Strmiids.lib |