KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION
KSPROPERTY_CAMERACONTROL_EXTENDED_RELATIVEPANELOPTIMIZATION est un ID de propriété utilisé pour indiquer au pilote si la caméra est face à l’avant ou non, par rapport à l’affichage actif de l’application. Windows définit la propriété lorsque la nouvelle propriété d’API WinRT PanelBasedOptimizationControl.Panel est définie.
Vous trouverez des exemples de définition des contrôles KSProperty dans l’exemple de pilote de caméra AVStream sur GitHub.
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
| Oui | Oui | Filtrer | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
Notes
La demande de propriété contient une structure KSCAMERA_EXTENDEDPROP_HEADER et une structure de KSCAMERA_EXTENDEDPROP_VALUE .
La taille totale des données de propriété est sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE).
Le membre Size de KSCAMERA_EXTENDEDPROP_HEADER est défini sur cette taille totale des données de propriété.
Les indicateurs suivants peuvent être placés dans le KSCAMERA_EXTENDEDPROP_HEADER. Indicateurs et KSCAMERA_EXTENDEDPROP_HEADER. Champs de capacité .
| Mode Optimisation du panneau relatif | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF | L’appareil photo utilise le mode de fonctionnement normal |
| KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON | La caméra utilise l’optimisation par rapport à une position décrite dans le champ valeur |
| KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC | L’indicateur d’emplacement de la caméra peut être ajusté dynamiquement lors de la diffusion en continu sans glitching du flux |
KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION est toujours un contrôle synchrone.
N’importe quelle application peut lire la propriété, mais seules les applications qui ont ouvert l’appareil photo pour un accès exclusif peuvent écrire dans la valeur de la propriété.
Un code d’erreur approprié est retourné si des tentatives d’écriture de la propriété sont effectuées sans avoir d’accès en mode exclusif.
En ce qui concerne le mappage de cette DDI au PanelBasedOptimizationControl, l’application qui utilise PanelBasedOptimizationControl définit la valeur Panel, que Windows utilisera en interne pour programmer le champ KSCAMERA_EXTENDEDPROP_VALUE de la charge utile.
Le champ Capacité et indicateurs sera contrôlé par Windows.
Si le pilote reçoit une opération SET alors que le périphérique de caméra est en streaming et que l’indicateur KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_DYNAMIC* n’est pas défini, le pilote retourne une erreur basée sur l’état.
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 | Cela doit être 1. |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| 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é | Doit être un peu sage OR des indicateurs de KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_XXX pris en charge définis ci-dessus. |
| Indicateurs | Il s’agit d’un champ en lecture/écriture. Il peut s’agir d’indicateurs KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON ou KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF définis ci-dessus. |
Si KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON est spécifié dans le champ Indicateurs du KSCAMERA_EXTENDEDPROP_HEADER, le champ Value.ul doit spécifier le PLD pour la direction relative de l’appareil photo.
Il peut s’agir de l’une des valeurs d’énumération pour ACPI PLD, mais le plus souvent, il s’agit de Front, Back ou Unknown.
Si KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF est spécifié, pour les opérations SET, le champ Valeur est ignoré.
Pour les opérations GET, le conducteur doit retourner la direction pour laquelle la caméra est actuellement programmée.
Si KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_OFF est spécifié ou si aucune valeur n’a été définie, le PLD par défaut de l’appareil doit être retourné.
Si KSCAMERA_EXTENDEDPROP_RELATIVEPANELOPTIMIZATION_ON est spécifié, la dernière valeur définie doit être retournée.
Spécifications
En-tête : ksmedia.h (inclure Ksmedia.h)