Partager via


KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS est un ID de propriété permettant aux pilotes de la caméra d’offrir plusieurs options fixes de champ de vue (FoV, field of view) que les utilisateurs peuvent sélectionner via la page ou les applications de configuration de la caméra.

  • Les valeurs de champ de vue signalées dans le tableau de charge utile KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS doivent être triées dans l’ordre décroissant, c'est-à-dire avec la plus grande valeur en premier.

  • Toutes les valeurs de champ de vue (FoV) signalées par KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS doivent être prises en charge sur tous les types de médias disponibles que le pilote choisit de prendre en charge.

    • Les pilotes peuvent effectuer une mise à l’échelle et/ou un rognage pour obtenir des FoV sur certaines résolutions.

    • Des exceptions peuvent être créées en prenant en charge des profils de caméra et en ajoutant KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 en tant que BlockedControl. Dans ce cas, le contrôle FIELDOFVIEW2 n’est pas du tout pris en charge lorsqu’un profil qui le bloque est utilisé.

Tableau récapitulatif de l'utilisation

Étendue Obtenir Yammer Définir Control Type
Version 1 Oui Non Filtrer Synchrone

Champs de la structure KSCAMERA_EXTENDEDPROP_HEADER

Le tableau suivant contient la configuration requise pour les champs de la structure KSCAMERA_EXTENDEDPROP_HEADER lorsque le contrôle est utilisé.

Membre Description
Version Doit être égal à 1.
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Size Doit être sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS)
Result Doit contenir 0. Ce champ n'est utilisé que pour retourner les résultats de la dernière opération SET asynchrone.
Fonctionnalité Doit être égal à 0.
Indicateurs Doit être égal à 0.

Charge utile KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS

La charge utile qui suit la structure de l’en-tête est obligatoirement KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS.

Paramètre Description
DefaultDiagonalFieldOfViewInDegrees La valeur par défaut du champ de vue (FoV). Il doit s'agir de l'une des valeurs indiquées dans le tableau DiscreteFoVStops.
DiscreteFoVStopsCount Nombre d’entrées valides dans DiscreteFovStops, maximum 360, minimum 1.
DiscreteFoVStops Tableau des champs de vue (FoV) valides, les seuls éléments valides sont DiscreteFoVStopsCount.
Reserved Définissez sur 0.

Spécifications

Client minimum supporté : Windows 11, version 24H2

En-tête : ksmedia.h (include Ksmedia.h)

Voir aussi

KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE

KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2