IAMExtTransport ::GetCapability, 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 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.]
La GetCapability méthode récupère les fonctionnalités générales du transport.
Syntaxe
HRESULT GetCapability(
[in] long Capability,
[out] long *pValue,
[out] double *pdblValue
);
Paramètres
[in] Capability
Spécifie la capacité à case activée. Pour plus d'informations, consultez la section Notes.
[out] pValue
Pointeur vers une variable qui reçoit un entier long . Pour plus d'informations, consultez la section Notes.
[out] pdblValue
Pointeur vers une variable qui reçoit un double. Pour plus d'informations, consultez la section Notes.
Valeur retournée
Lorsque cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .
Remarques
Le paramètre Capability est un indicateur qui spécifie la capacité à case activée. La méthode retourne le résultat dans le paramètre pValue ou dans le paramètre pdblValue , en fonction de l’indicateur de capacité.
Pour les indicateurs suivants, la méthode retourne la valeur OATRUE ou OAFALSE dans le paramètre pValue . La valeur OATRUE indique que la fonctionnalité est présente, tandis que la valeur OAFALSE indique qu’elle est absente.
| Indicateur de capacité | Description |
|---|---|
| ED_TRANSCAP_CAN_ASSEMBLE | Le transport peut utiliser le mode d’enregistrement d’assemblage (enregistrer les nouvelles pistes qui se relient en toute transparence à la piste de contrôle à partir du segment précédemment enregistré). |
| ED_TRANSCAP_CAN_BUMP_PLAY | Le transport peut se synchroniser à une vitesse variable. |
| ED_TRANSCAP_CAN_DELAY_AUDIO_IN | Le transport peut effectuer des modifications audio différées. |
| ED_TRANSCAP_CAN_DELAY_AUDIO_OUT | Le transport peut effectuer des modifications audio différées. |
| ED_TRANSCAP_CAN_DELAY_VIDEO_IN | Le transport peut effectuer des modifications vidéo différées. |
| ED_TRANSCAP_CAN_DELAY_VIDEO_OUT | Le transport peut effectuer des modifications vidéo différées. |
| ED_TRANSCAP_CAN_DETECT_LENGTH | Le transport peut détecter la longueur du média. |
| ED_TRANSCAP_CAN_EJECT | Le transport peut éjecter le média. |
| ED_TRANSCAP_CAN_FREEZE | Le transport peut geler/suspendre. |
| ED_TRANSCAP_CAN_INSERT | Le transport peut utiliser le mode d’insertion d’enregistrement (enregistrer des pistes individuelles lorsqu’elles sont verrouillées sur une piste de contrôle préenregistrée). |
| ED_TRANSCAP_CAN_PLAY_BACKWARDS | Le transport peut jouer vers l’arrière. |
| ED_TRANSCAP_CAN_SET_EE | Le transport peut afficher l’entrée de l’appareil sur sa sortie. |
| ED_TRANSCAP_CAN_SET_PB | Le transport peut afficher la lecture multimédia sur sa sortie. |
| ED_TRANSCAP_FIELD_STEP | Le transport répond à une commande d’avance de trame en faisant avancer un champ. |
| ED_TRANSCAP_HAS_CLOCK | L’appareil a une horloge. |
| ED_TRANSCAP_HAS_DT | L’appareil dispose d’un suivi dynamique. |
| ED_TRANSCAP_HAS_TIMER | L’appareil a un minuteur. |
| ED_TRANSCAP_HAS_TUNER | L’appareil dispose d’un tuner. |
| ED_TRANSCAP_IS_MASTER | L’appareil est l’horloge master pour la synchronisation. |
| ED_TRANSCAP_MULTIPLE_EDITS | L’appareil prend en charge plusieurs événements de modification. |
| ED_TRANSCAP_NEEDS_CUEING | L’appareil doit être cueded avant d’effectuer une modification. |
| ED_TRANSCAP_NEEDS_TBC | L’appareil doit être étalonné. |
Pour les indicateurs suivants, la méthode retourne une valeur numérique dans le paramètre pValue .
| Indicateur de capacité | Valeur renvoyée |
| ED_TRANSCAP_LTC_TRACK | Retourne le numéro de piste de la piste de timecode LTC, ou ED_ALL s’il n’existe aucune piste de timecode dédiée. |
| ED_TRANSCAP_NUM_AUDIO_TRACKS | Retourne le nombre de pistes audio. |
Pour les indicateurs suivants, la méthode retourne une valeur dans le paramètre pdblValue .
| Indicateur de capacité | Valeur renvoyée |
| ED_TRANSCAP_FWD_SHUTTLE_MAX | Vitesse maximale avant en mode navette, en tant que multiple de la vitesse de lecture. |
| ED_TRANSCAP_FWD_SHUTTLE_MIN | Vitesse avancée minimale en mode navette, comme multiple de la vitesse de lecture. |
| ED_TRANSCAP_FWD_VARIABLE_MAX | Vitesse maximale avant, en tant que multiple de la vitesse de lecture. |
| ED_TRANSCAP_FWD_VARIABLE_MIN | Vitesse minimale vers l’avant, en tant que multiple de la vitesse de lecture. |
| ED_TRANSCAP_REV_SHUTTLE_MAX | Vitesse inversée maximale en mode navette, sous la forme d’un multiple de la vitesse de lecture. |
| ED_TRANSCAP_REV_SHUTTLE_MIN | Vitesse inversée minimale en mode navette, en tant que multiple de la vitesse de lecture. |
| ED_TRANSCAP_REV_VARIABLE_MAX | Vitesse inversée maximale, en tant que multiple de la vitesse de lecture. |
| ED_TRANSCAP_REV_VARIABLE_MIN | Vitesse inversée minimale, en tant que multiple de la vitesse de lecture. |
Implémentation de DV
MSDV ne prend pas en charge cette méthode. Il retourne E_NOTIMPL.
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 |