Partager via


KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW

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.

Spécifications

Client minimum pris en charge : Windows 11

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

Voir aussi

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_CONFIGCAPS

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_CONFIGCAPSHEADER

KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_SETTING

KSCAMERA_METADATA_DIGITALWINDOW