KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE
KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE est un contrôle dynamique qui réduit la fréquence d’images de la vidéo par un facteur d’échelle de la fréquence d’images d’origine.
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
| Oui | Oui | Filtre | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
La valeur de propriété (données d’opération) contient une structure KSCAMERA_EXTENDEDPROP_HEADER et une structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.
La taille totale des données de propriété est taille de(KSCAMERA_EXTENDEDPROP_HEADER) + taille de(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Le membre Size de KSCAMERA_EXTENDEDPROP_HEADER est défini sur cette taille totale des données de propriété.
La fonctionnalité membre de KSCAMERA_EXTENDEDPROP_HEADER contient l’une des valeurs suivantes.
| Contrôle de limitation de fréquence d’images | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF | La limitation de fréquence d’images est désactivée. |
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON | La limitation de fréquence d’images est activée. |
Les indicateurs membre de KSCAMERA_EXTENDEDPROP_HEADER contiennent l’indicateur actuellement défini pour la caméra. KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF doit être la valeur par défaut.
Ce contrôle de propriété est synchrone et n’est pas annulable.
Ce contrôle s’applique uniquement lorsque l’appareil photo est activement en streaming. Pour être en streaming actif, un aperçu ou une broche d’enregistrement doit être dans KSSTATE_RUN, prêt et capable de fournir des images. Sur un jeu si un flux n’est pas actif, ce contrôle doit retourner STATUS_INVALID_DEVICE_STATE. Même s’il s’agit d’un contrôle d’étendue de filtre, cela ne doit pas avoir d’impact sur les flux photo-broche ou non RVB tels que le runtime d’intégration/profondeur.
Remarques
Obtenir la propriété
Lorsque vous répondez à une demande de KSPROPERTY_TYPE_GET, le pilote définit les membres de l'KSCAMERA_EXTENDEDPROP_HEADER sur ce qui suit.
| Membre | Valeur |
|---|---|
| Version | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Taille | Doit être taille de(KSCAMERA_EXTENDEDPROP_HEADER) + taille de(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) |
| Résultat | Doit être 0. Ce champ est utilisé pour retourner le résultat de la dernière opération SET. |
| Capacité | KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON ou 0x1 |
| Drapeaux | Cela peut être KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON ou KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF. |
Si aucun indicateur de limitation de vitesse d’image n’a été défini précédemment, le pilote définit indicateurs sur KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF. Les membres de la structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING qui suit KSCAMERA_EXTENDEDPROP_HEADER sont définis en fonction des exigences du mode de limitation de fréquence d’images.
Définir la propriété
Lorsque la propriété est définie, une requête KSPROPERTY_TYPE_SET, l’indicateur membre de KSCAMERA_EXTENDEDPROP_HEADER contient le mode de limitation de vitesse d’image à définir. Le membre VideoProc.Value de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING doit être ignoré lorsque indicateurs contient l’indicateur de KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF.
Structure de charge utile
Le tableau suivant contient les descriptions et les conditions requises pour les champs de structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING pour le DDI de limitation de vitesse d’image. Cette structure est définie dans ksmedia.h.
| Membre | Description |
|---|---|
| Mode | Cela n’est pas utilisé et doit être 0. |
| Min/Max/Step | Le nombre maximal doit être de 100, ce qui indique qu’aucune modification n’est apportée à la fréquence d’images. L’étape doit être un facteur de 100 de sorte que Max % Step == 0. Min doit être égal à au moins une taille d’étape ou à un multiple de la taille de l’étape. Min ne peut pas être 0. |
| VideoProc | VideoProc.Value.ul doit spécifier le pourcentage de facteur d’échelle pour ce contrôle. Cette valeur doit se trouver dans la plage Min et Max, et elle doit être définie sur un multiple de la valeur Step. En définissant cette valeur de manière appropriée, une application peut s’assurer que la nouvelle fréquence d’images ne dépasse jamais la valeur d’origine, ni atteindre zéro. Par exemple, la définition d’une valeur de 80 produit une fréquence d’images de 80% de la fréquence d’images d’origine. |
| Réservé | Cela n’est pas utilisé. Cela doit être ignoré par le pilote. |
Spécifications
client minimum pris en charge : Windows 11, version 24H2
En-tête : ksmedia.h (inclure Ksmedia.h)