KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR
KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR permet d’activer ou de désactiver la vidéo HDR (High Dynamic Range) sur le pilote. Il s’agit d’un contrôle de niveau d’épingle pour la broche vidéo uniquement.
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété |
|---|---|---|---|
| Oui | Oui | Épingle | KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR |
Les indicateurs suivants peuvent être placés dans le KSCAMERA_EXTENDEDPROP_HEADER. Champ Indicateurs pour contrôler la vidéo HDR. Par défaut, le pilote doit être défini sur VIDEOHDR_OFF.
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON 0x0000000000000001
#define KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO 0x0000000000000002
Si le pilote prend en charge ce contrôle, il doit prendre en charge VIDEOHDR_ON/VIDEOHDR_OFF.
Si le pilote ne prend pas en charge la vidéo HDR, il ne doit pas implémenter ce contrôle.
Ce contrôle sert d’indicateur au pilote. Lorsqu’il est défini sur VIDEOHDR_ON, le pilote doit effectuer la vidéo HDR comme le meilleur effort.
L’appel SET de ce contrôle n’a aucun effet lorsque la broche vidéo est KSSTATE_RUN état. Le pilote doit rejeter l’appel SET reçu si la broche vidéo est en cours d’exécution et retourne STATUS_INVALID_DEVICE_STATE. Dans un appel GET, le pilote doit retourner les paramètres actuels dans le champ Indicateurs.
Le tableau suivant décrit les fonctionnalités d’indicateur.
| Indicateur | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_OFF | Il s’agit d’une fonctionnalité obligatoire. Lorsque cette option est spécifiée, la vidéo HDR est désactivée dans le pilote et le pilote ne doit pas effectuer de hdr vidéo sur le flux vidéo. |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_ON | Il s’agit d’une fonctionnalité obligatoire. Lorsqu’il est spécifié, la vidéo HDR est activée dans le pilote et le pilote doit effectuer la vidéo HDR comme le meilleur effort. Cet indicateur s’exclue mutuellement avec les indicateurs VIDEOHDR_AUTO et VIDEOHDR_OFF. |
| KSCAMERA_EXTENDEDPROP_VIDEOHDR_AUTO | Cette fonctionnalité est facultative. Lorsqu’il est spécifié, le pilote qui prend en charge cette fonctionnalité détermine si la vidéo HDR doit être effectuée en fonction de l’analyse de la scène. Cet indicateur s’exclue mutuellement avec les indicateurs VIDEOHDR_ON et VIDEOHDR_OFF. |
Le tableau ci-dessous contient les descriptions et les conditions requises pour les champs de structure KSCAMERA_EXTENDEDPROP_HEADER lors de l’utilisation du contrôle.
| Membre | Description |
|---|---|
| Version | Cela doit être 1. |
| PinId | Doit être l’ID de code pin 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é | Doit être un OR au niveau du bit des indicateurs KSCAMERA_EXTENDEDPROP_VIDEOHDR_* pris en charge définis ci-dessus. |
| Indicateurs | Il s’agit d’un champ en lecture/écriture. Il peut s’agir d’un des indicateurs KSCAMERA_EXTENDEDPROP_VIDEOHDR_* définis ci-dessus. |
Spécifications
Client minimum pris en charge : Windows 11
En-tête : ksmedia.h (inclure Ksmedia.h)