structure KSCAMERA_MAXVIDEOFPS_FORPHOTORES (ksmedia.h)

Article
02/26/2024

La structure KSCAMERA_MAXVIDEOFPS_FORPHOTORES contient les données de propriété pour la fréquence d’images maximale à une résolution particulière pour une caméra prenant en charge la préversion et la capture. Cette structure est utilisée lors de la définition ou de la récupération des données pour la propriété de contrôle étendu KSPROPERTY_CAMERACONTROL_EXTENDED_MAXVIDFPS_PHOTORES.

Syntaxe

typedef struct tagKSCAMERA_MAXVIDEOFPS_FORPHOTORES {
  ULONG PhotoResWidth;
  ULONG PhotoResHeight;
  ULONG PreviewFPSNum;
  ULONG PreviewFPSDenom;
  ULONG CaptureFPSNum;
  ULONG CaptureFPSDenom;
} KSCAMERA_MAXVIDEOFPS_FORPHOTORES, *PKSCAMERA_MAXVIDEOFPS_FORPHOTORES;

Membres

PhotoResWidth

Largeur de la résolution de la photo en pixels.

PhotoResHeight

Hauteur de résolution de la photo en pixels.

PreviewFPSNum

Valeur de numérateur de la fréquence d’images d’aperçu.

PreviewFPSDenom

Valeur dénominateur de la fréquence d’images d’aperçu.

CaptureFPSNum

Valeur de numérateur de la fréquence d’images de capture.

CaptureFPSDenom

Valeur dénominateur de la fréquence d’images de capture.

Remarques

Lors de la définition de la propriété, à l’aide d’une demande de KSPROPERTY_TYPE_SET, les membres PhotoResWidth et PhotoResHeight sont fournis par l’application en fonction des types de supports photo disponibles. Le pilote de la caméra doit conserver ces informations de résolution en interne. Les membres de fréquence d’images d’aperçu et de capture doivent être ignorés par le pilote sur KSPROPERTY_TYPE_SET demandes.

Pour toute demande de KSPROPERTY_TYPE_GET ultérieure, le pilote de caméra, en fonction de la résolution fournie dans la demande de KSPROPERTY_TYPE_SET précédente, doit fournir les fréquences d’images pour les flux d’aperçu et de capture. En outre, le pilote de l’appareil photo doit définir PhotoResWidth et PhotoResHeight sur la résolution fournie avec la demande de KSPROPERTY_TYPE_SET.

Si aucune demande de KSPROPERTY_TYPE_SET n’a été effectuée pour la session, le pilote de caméra a défini tous les membres de la structure KSCAMERA_MAXVIDEOFPS_FORPHOTORES sur 0.

Si l’aperçu ou la capture ne sont pas pris en charge, par exemple lorsque l’appareil photo est un appareil photo double épinglé avec une seule broche vidéo, il doit utiliser les membres CaptureFPSNum et CaptureFPSDenom et définir les membres PreviewFPSNum et PreviewFPSDenom sur 0.

Si KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE est pris en charge sur le contrôle mode photo par le pilote de l’appareil photo, ce contrôle est obligatoire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1
Serveur minimal pris en charge	Windows Server 2012 R2
En-tête	ksmedia.h (incluez Ksmedia.h)

Partager via