KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE
KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE est un contrôle dynamique qui réduit la fréquence d’images d'une vidéo en appliquant un facteur d’échelle à la fréquence d’images d’origine.
Tableau récapitulatif de l'utilisation
| Obtenir Yammer | Définir | Cible | Tableau récapitulatif d’utilisation | Type de valeur de propriété |
|---|---|---|---|---|
| Oui | Oui | Filtrer | 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 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Le membre Size de KSCAMERA_EXTENDEDPROP_HEADER est ajusté sur cette valeur de taille totale des données de propriété.
Le membre Capability de KSCAMERA_EXTENDEDPROP_HEADER contient l’une des valeurs suivantes.
| Contrôle de limitation de la fréquence d'images | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF | La limitation de la fréquence d'images est désactivée. |
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON | La limitation de la fréquence d'images est activée. |
Le membre Flags de KSCAMERA_EXTENDEDPROP_HEADER contient 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 ne peut pas être annulé.
Ce contrôle s’applique uniquement lorsque la caméra est en streaming actif. Pour que la caméra soit considérée en streaming actif, une broche de preview ou d'enregistrement doit se trouver dans KSSTATE_RUN, prête et disposée à fournir des images. Sur un jeu n'ayant pas de streaming actif, ce contrôle doit retourner STATUS_INVALID_DEVICE_STATE. Même s’il s’agit d’un contrôle d’étendue de filtre, il ne doit y avoir aucun impact sur les broches photos ou les flux non RVB (IR/profondeur).
Notes
Obtenir la propriété
Lorsqu'il répond à une requête de KSPROPERTY_TYPE_GET, le pilote définit les membres de KSCAMERA_EXTENDEDPROP_HEADER de la manière suivante.
| Membre | Valeur |
|---|---|
| Version | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Size | Doit être sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) |
| Result | Doit être égal à 0. Ce champ est utilisé pour retourner le résultat de la dernière opération SET. |
| Fonctionnalité | KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON ou 0x1 |
| Indicateurs | Cela peut être soit KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON, soit KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF. |
Si aucun indicateur de limitation de la fréquence d'images n’a été défini précédemment, le pilote définit les 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 la fréquence d'images.
Définir la propriété
Lorsque la propriété est définie, une requête KSPROPERTY_TYPE_SET, le membre Flags de KSCAMERA_EXTENDEDPROP_HEADER contient le mode de limitation de la fréquence d'images à définir. Le membre VideoProc.Value de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING doit être ignoré lorsque Flags contient l’indicateur KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF.
Structure de charge utile
Le tableau suivant rassemble les descriptions et les conditions requises pour les champs de la structure KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING pour le DDI de limitation de la fréquence d'images. Cette structure est définie dans ksmedia.h.
| Membre | Description |
|---|---|
| Mode | Non utilisé, doit être égal à 0. |
| Min/Max/Pas | La valeur Max doit être de 100, ce qui indique qu’aucune modification n’est apportée à la fréquence d'images. La valeur de Pas doit être un facteur de 100, de sorte que Pas % Max == 0. La valeur Min doit être égale à au moins un pas ou à un multiple de la valeur de pas. La valeur Min ne peut pas être nulle. |
| VideoProc | VideoProc.Value.ul doit préciser le pourcentage de facteur d’échelle pour ce contrôle. Cette valeur doit être comprise entre Min et Max, et correspondre à un multiple de la valeur de Pas. Une définition appropriée de cette valeur permet à une application de s'assurer que la nouvelle fréquence d'images ne dépasse jamais sa valeur d’origine, et n'est jamais nulle. Par exemple, une valeur de 80 produit une fréquence d'images égale à 80 % de la fréquence d’origine. |
| Reserved | Non utilisé. À ignorer par le pilote. |
Spécifications
Client minimum supporté : Windows 11, version 24H2
En-tête : ksmedia.h (include Ksmedia.h)