Partager via


KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOSTABILIZATION

Ce contrôle de propriété étendu est utilisé pour contrôler la stabilisation vidéo numérique dans driver\MFT0.

Tableau récapitulatif de l’utilisation

Étendue Control Type

version 1

Épingle

Synchrone

Les indicateurs suivants qui peuvent être placés dans le KSCAMERA_EXTENDEDPROP_HEADER. Signale les indicateurs de champ pour contrôler la stabilisation vidéo numérique dans driver\MFT0. Par défaut, la stabilisation vidéo doit être désactivée pour le pilote.

#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF       0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON        0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO      0x0000000000000002

Si le pilote ne prend pas en charge la stabilisation vidéo numérique, il ne doit pas implémenter ce contrôle.

Si le pilote prend en charge ce contrôle, il doit prendre en charge VIDEOSTABILIZATION_ON\OFF.

L’appel SET de ce contrôle n’a aucun effet lorsque l’épingle vidéo est dans un état supérieur à l’état KSSTATE_STOP. Le pilote doit rejeter l’appel SET reçu si la broche vidéo n’est pas à l’état d’arrêt et retourne STATUS_INVALID_DEVICE_STATE. Dans un appel GET, le pilote doit retourner les paramètres actuels dans le champ Indicateurs.

Lorsque ce contrôle est utilisé dans le contexte d’un profil, le profil doit servir d’indicateur au pilote pour le mode qualité. Le pilote peut déterminer s’il faut optimiser une faible latence ou une haute qualité lorsque la stabilisation vidéo est activée en fonction du profil sélectionné, par exemple, une vidéoconférence ou un enregistrement vidéo de haute qualité.

Notes

PROPSETID_VIDCAP_CAMERACONTROL_VIDEO_STABILIZATION sera déconseillé pour Windows 10.

Le tableau suivant décrit les fonctionnalités d’indicateur.

Indicateur Description

KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_OFF

Il s’agit d’une fonctionnalité obligatoire. Quand elle est spécifiée, la stabilisation vidéo numérique est désactivée dans driver\MFT0.

KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_ON

Il s’agit d’une fonctionnalité obligatoire. Quand elle est spécifiée, la stabilisation vidéo numérique est activée dans driver\MFT0 et le paramètre de remplissage de suranalyse par défaut est à la charge du pilote. Cet indicateur s’exclut mutuellement avec les indicateurs AUTO et OFF.

KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_AUTO

Cette fonctionnalité est facultative. Lorsqu’il est spécifié, le pilote qui prend en charge cette fonctionnalité détermine si la stabilisation vidéo doit être effectuée et la quantité de stabilisation à appliquer en fonction de l’analyse de la scène et du scénario de capture. Cet indicateur s’exclut mutuellement des indicateurs ON et OFF.

Notes

Selon l’implémentation, la mémoire tampon suranalysée peut être allouée par le pilote en interne ou par le pipeline.

Si la mémoire tampon surscannée doit être allouée par le pilote, le pilote doit publier à la fois le type de média standard et le type de média suranalysé. Le MFT0 doit publier le type de média standard. Lors de la définition du type de média standard sur le type de média de sortie MFT0, le MFT0 doit sélectionner le type de média surscanné correspondant à partir des types de médias publiés par le pilote comme type de média d’entrée, si la stabilisation vidéo est activée. Si la stabilisation vidéo est désactivée, le MFT0 doit sélectionner le type de média standard comme type de média d’entrée. Le MFT0 doit retourner MF_E_INVALIDMEDIATYPE si le type de média surscanné est défini comme type de média de sortie lorsque la stabilisation vidéo est activée.

Si la mémoire tampon suranalysée est allouée par le pilote, le pilote et MFT0 doivent tous deux publier les types de médias standard. MFT0 doit définir le type de média standard pour son type de média d’entrée et son type de média de sortie.

Pour prendre en charge la stabilisation vidéo basée sur les effets (c’est-à-dire, la stabilisation vidéo effectuée ni dans le pilote ni dans MFT0), le pilote et MFT0 doivent en outre publier le type de média surscanné. Dans ce cas, les types de supports standard et suranalysés sont exposés par le pilote et MFT0. Les règles suivantes s’appliquent pour garantir que la stabilisation vidéo basée sur les effets et la stabilisation vidéo basée sur driver\MFT0 fonctionnent correctement.

  • Si un type de média suranassé est défini comme type de média de sortie MFT0 alors que la stabilisation vidéo basée sur le pilote\MFT0 est activée, MFT0 doit retourner MF_E_INVALIDMEDIATYPE.

  • Si un type de média standard est défini comme type de média de sortie MFT0, l’application doit retourner une erreur lors de la tentative d’activation de la stabilisation vidéo basée sur l’effet si la stabilisation vidéo basée sur l’effet ne peut prendre que le type de média suranalysé.

Le tableau ci-dessous contient les descriptions et la configuration requise pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation du contrôle de stabilisation vidéo.

Membre Description

Version

Cela doit être 1.

PinId

Doit être l’ID d’épingle associé à l’épingle vidéo.

Taille

Il doit s’agir de sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).

Résultats

Indique les résultats d’erreur de la dernière opération SET. Si aucune opération SET n’a eu lieu, il doit s’agir de 0.

Fonctionnalité

Il doit s’agir d’un or au niveau du bit des indicateurs de KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX pris en charge, comme défini ci-dessus.

Indicateurs

Il s’agit d’un champ en lecture/écriture. Il peut s’agir d’un des indicateurs KSCAMERA_EXTENDEDPROP_VIDEOSTABILIZATION_XXX définis ci-dessus.

Configuration requise

En-tête

Ksmedia.h