KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

Article
06/15/2023

KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW est un ID de propriété qui spécifie le champ d’affichage et le zoom de l’appareil photo pendant la diffusion en continu.

Ce contrôle peut remplacer le panoramique, l’inclinaison et le zoom. Ce contrôle s’applique uniquement pendant que la caméra est activement en streaming. Pour être activement en streaming, une préversion ou une broche d’enregistrement doit être en KSSTATE_RUN, prête et capable de fournir des images.

Sur SET, si un flux n’est pas actif, ce contrôle retourne STATUS_INVALID_DEVICE_STATE.

Vous trouverez des exemples de définition de contrôles KSPROPERTY dans l’exemple de pilote de caméra AVStream sur GitHub.

Tableau récapitulatif de l’utilisation

Étendue	Control	Type
version 1	Filtrer	Synchrone

Les indicateurs de bits suivants contrôlent l’ID de propriété dans le pilote :

#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL             0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING    0x0000000000000001

Description de la capacité

Les indicateurs suivants peuvent être placés dans le KSCAMERA_EXTENDEDPROP_HEADER. Indicateurs et KSCAMERA_EXTENDEDPROP_HEADER. Champs de capacité .

Indicateur	Description
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL	La fenêtre numérique est contrôlée manuellement par l’application.
KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING	L’appareil photo ajuste automatiquement la fenêtre numérique pour qu’elle se concentre sur le visage dominant en vue.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW est toujours un contrôle synchrone.

Le tableau suivant contient les conditions requises pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation du contrôle de métadonnées.

Membre	Description
Version	Doit être égal à 1.
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Taille	Doit être sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+ sizeof(KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING)
Résultats	Doit contenir 0. Ce champ est utilisé uniquement pour retourner le résultat de la dernière opération SET asynchrone.
Fonctionnalité	Doit prendre en charge KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL. Peut éventuellement prendre en charge KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.
Indicateurs	Doit être KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_MANUAL ou KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING.

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

Ces paramètres sont en lecture seule si KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING est défini dans le champ Indicateurs. Si KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING est défini pendant une opération SET, les paramètres suivants sont ignorés.

Paramètre	Description
OriginX	Origine de la fenêtre numérique le long de l’axe X au format Q24. Doit avoir la valeur par défaut 0. OriginX ne peut pas être inférieur à PorchLeft ni supérieur à PorchRight – WindowSize.
Origine	Origine de la fenêtre numérique le long de l’axe X au format Q24. Doit avoir la valeur par défaut 0. OriginX ne peut pas être inférieur à PorchLeft ni supérieur à PorchRight – WindowSize.
WindowSize	Taille de la fenêtre numérique le long des deux axes au format Q24. Il s’agit de la fraction de la vue complète visible le long des axes x et y. WindowSize doit par défaut 0x01000000 (1.0 au T24). WindowSize ne peut pas être inférieur à MinWindowSize ni supérieur à MaxWindowSize. En outre, WindowSize plus OriginX ne peut pas être supérieur à PorchRight ; WindowsSize plus OriginY peut ne pas être supérieur à PorchBottom.
Réservé	Définit la valeur 0.