IamExtDevice ::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 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 GetCapability méthode récupère les fonctionnalités de l’appareil externe.
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, elle retourne un code d’erreur HRESULT .
Remarques
Le paramètre Capability est un indicateur qui spécifie la fonctionnalité à 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 fonctionnalité | Description |
|---|---|
| ED_DEVCAP_AUDIO_INPUTS | L’appareil accepte l’entrée audio. |
| ED_DEVCAP_CAN_MONITOR_SOURCES | L’appareil peut envoyer n’importe quelle entrée à la sortie surveillée, quelle que soit l’entrée actuellement sélectionnée. |
| ED_DEVCAP_CAN_PREVIEW | L’appareil peut afficher un aperçu. |
| ED_DEVCAP_CAN_RECORD | L’appareil peut enregistrer. |
| ED_DEVCAP_CAN_RECORD_STROBE | L’appareil peut stroboscopiquer l’enregistrement. Cette fonctionnalité s’applique aux appareils multipiste qui peuvent enregistrer sur les pistes sélectionnées. |
| ED_DEVCAP_CAN_SAVE | L’appareil peut enregistrer des données. |
| ED_DEVCAP_CTLTRK_READ | L’appareil peut lire les pistes de contrôle. |
| ED_DEVCAP_HAS_AUDIO | L’appareil a de l’audio. |
| ED_DEVCAP_HAS_VIDEO | L’appareil a une vidéo. |
| ED_DEVCAP_INDEX_READ | L’appareil peut lire les marques d’index. |
| ED_DEVCAP_NEEDS_CALIBRATING | L’appareil doit être calibré. Consultez IAMExtDevice ::Calibration. |
| ED_DEVCAP_TIMECODE_READ | L’appareil peut lire le code de temps SMPTE. |
| ED_DEVCAP_TIMECODE_WRITE | L’appareil peut définir le code de temps SMPTE. |
| ED_DEVCAP_USES_FILES | L’appareil dispose d’un système de fichiers intégré. |
| ED_DEVCAP_VIDEO_INPUTS | L’appareil accepte l’entrée vidéo. |
Pour les indicateurs suivants, la méthode retourne une constante définie dans le paramètre pValue .
ED_DEVCAP_DEVICE_TYPE : retourne le type d’appareil.
| Constante retournée | Description |
|---|---|
| ED_DEVTYPE_ATR | Magnétophone audio |
| ED_DEVTYPE_CG | Générateur de caractères |
| ED_DEVTYPE_DDR | Enregistreur de disque numérique |
| ED_DEVTYPE_DVE | Unité d’effets vidéo numériques |
| ED_DEVTYPE_GPI | Déclencheur d’interface à usage général |
| ED_DEVTYPE_KEYER | Keyer vidéo |
| ED_DEVTYPE_LASERDISK | Laserdisc |
| ED_DEVTYPE_MIXER_AUDIO | Mixeur audio |
| ED_DEVTYPE_MIXER_VIDEO | Mixeur vidéo |
| ED_DEVTYPE_ROUTER | Routeur vidéo |
| ED_DEVTYPE_TBC | Correcteur timebase |
| ED_DEVTYPE_TCG | Générateur/lecteur de code temporel |
| ED_DEVTYPE_VCR | Magnétoscope ou caméscope avec fonctionnalités complètes de magnétoscope |
| ED_DEVTYPE_WIPEGEN | Générateur de réinitialisation vidéo |
| ED_DEVTYPE_JOYSTICK | Joystick |
| ED_DEVTYPE_KEYBOARD | Clavier |
ED_DEVCAP_SYNC_ACCURACY : retourne une indication de la précision de synchronisation de l’appareil.
| Constante retournée | Description |
|---|---|
| ED_SYNCACC_PRECISE | L’appareil a une précision précise. |
| ED_SYNCACC_FRAME | L’appareil est précis pour le cadre. |
| ED_SYNCACC_ROUGH | L’appareil est inférieur à la précision du cadre. |
ED_DEVCAP_NORMAL_RATE : retourne la fréquence d’images normale de l’appareil.
| Constante retournée | Description |
|---|---|
| ED_RATE_24 | 24 images par seconde (fps) |
| ED_RATE_25 | 25 fps |
| ED_RATE_2997 | 29,97 fps |
| ED_RATE_30 | 30 fps |
ED_DEVCAP_SEEK_TYPE : retourne une indication de la précision de recherche de l’appareil.
| Constante retournée | Description |
|---|---|
| ED_SEEK_PERFECT | L’appareil peut rechercher dans une image vidéo sans rupture de signal. |
| ED_SEEK_FAST | L’appareil peut rechercher rapidement, avec une courte pause dans le signal. |
| ED_SEEK_SLOW | L’appareil recherche lentement ; comme le transport sur bande. |
Pour les indicateurs suivants, la méthode retourne une valeur numérique dans le paramètre pValue .
| Indicateur de capacité | Valeur renvoyée |
| ED_DEVCAP_EXTERNAL_DEVICE_ID | Identificateur spécifique au fabricant. |
| ED_DEVCAP_PREROLL | Heure de pré-inscription de l’appareil. |
| ED_DEVCAP_POSTROLL | Temps de post-inscription de l’appareil. |
Dans Windows XP Service Pack 2 et versions ultérieures, les indicateurs supplémentaires suivants sont pris en charge pour ED_DEVCAP_DEVICE_TYPE.
| Constante retournée | Description |
|---|---|
| ED_DEVTYPE_CAMERA_STORAGE | Stockage pour les images fixes ou les fichiers vidéo courts. |
| ED_DEVTYPE_DTV | Télévision numérique avec interface de bus série. |
| ED_DEVTYPE_PC_VIRTUAL | Appareil virtuel ou émulé sur un ordinateur. |
Pour utiliser ces constantes, incluez le fichier d’en-tête Xprtdefs.h.
Implémentation de DV
Les pilotes MSDV et UVC prennent en charge les comportements suivants.L’indicateur ED_DEVCAP_NORMAL_RATE retourne la fréquence d’images.
| Constante retournée | Description |
|---|---|
| ED_RATE_25 | 25 ips (fréquence d’images PAL par défaut) |
| ED_RATE_2997 | 29,997 images par seconde (fréquence d’images NTSC par défaut) |
Pour MSDV uniquement, l’indicateur ED_DEVCAP_DEVICE_TYPE renvoie le type d’appareil. Les valeurs possibles sont présentées dans le tableau suivant. Pour les appareils UVC, utilisez plutôt l’interface IKsTopologyInfo .
| Constante retournée | Description |
|---|---|
| ED_DEVTYPE_CAMERA | Caméra simple qui peut enregistrer ou suspendre l’enregistrement, mais ne dispose pas de toutes les fonctionnalités de magnétoscope. |
| ED_DEVTYPE_DVHS | L’appareil prend en charge le format D-VHS. |
| ED_DEVTYPE_UNKNOWN | Type d’appareil inconnu. |
| ED_DEVTYPE_VCR | L’appareil a des fonctionnalités de magnétoscope complètes. |
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 |