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, IMFMediaEngineet audio/vidéo capture dans 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 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 méthode GetCapability 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 fonctionnalité à vérifier. Pour plus d’informations, consultez les remarques.
[out] pValue
Pointeur vers une variable qui reçoit un entier long. Pour plus d’informations, consultez les remarques.
[out] pdblValue
Pointeur vers une variable qui reçoit une double. Pour plus d’informations, consultez les remarques.
Valeur de retour
Lorsque cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT.
Remarques
Le paramètre Fonctionnalité est un indicateur qui spécifie la fonctionnalité à vérifier. La méthode retourne le résultat dans le paramètre pValue
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_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 enregistrer des strobe. Cette fonctionnalité s’applique aux appareils multitrack 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 a besoin d’un calibrage. Voir IAMExtDevice ::Étalonner. |
| 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 | Enregistreur de bande 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 timecode |
| ED_DEVTYPE_VCR | VCR ou camcorder avec des fonctionnalités de vcR complètes |
| 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. |
| ED_SYNCACC_ROUGH | L’appareil est inférieur à la précision de l’image. |
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 recherchée 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 un court saut dans le signal. |
| ED_SEEK_SLOW | L’appareil cherche lentement ; tels que le transport de bandes. |
Pour les indicateurs suivants, la méthode retourne une valeur numérique dans le paramètre pValue.
| Indicateur de fonctionnalité | Valeur retournée |
| ED_DEVCAP_EXTERNAL_DEVICE_ID | Identificateur spécifique au fabricant. |
| ED_DEVCAP_PREROLL | Temps 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 d'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 fps (fréquence d’images PAL par défaut) |
| ED_RATE_2997 | 29,997 fps (fréquence d’images NTSC par défaut) |
Pour MSDV uniquement, l’indicateur ED_DEVCAP_DEVICE_TYPE retourne le type d’appareil. Les valeurs possibles sont indiquées dans le tableau suivant. Pour les appareils UVC, utilisez l’interface IKsTopologyInfo à la place.
| Constante retournée | Description |
|---|---|
| ED_DEVTYPE_CAMERA | Caméra simple capable d’enregistrer ou de suspendre l’enregistrement, mais qui ne dispose pas de fonctionnalités vcR complètes. |
| ED_DEVTYPE_DVHS | L’appareil prend en charge le format D-VHS. |
| ED_DEVTYPE_UNKNOWN | Type d’appareil inconnu. |
| ED_DEVTYPE_VCR | L’appareil dispose de fonctionnalités complètes de vcR. |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | strmif.h (include Dshow.h) |
| bibliothèque | Strmiids.lib |