Partager via

IAMExtTransport ::GetStatus, méthode (strmif.h)

  • Article

[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.
Dans Windows XP Service Pack 2 et versions ultérieures, les modes de lecture supplémentaires suivants sont définis pour ED_MODE.
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

Voir aussi

Codes d’erreur et de réussite

IAMExtTransport, interface