KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY
Die KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY-Eigenschafts-ID, die in der KSPROPERTY_CAMERACONTROL_EXTENDED_PROPERTY-Enumeration definiert ist, wird verwendet, um die Fokuspriorität zu konfigurieren. Wenn die Fokuspriorität festgelegt ist, hat die Fokussierung Vorrang vor dem aufgenommenen Bild, um sicherzustellen, dass das aufgenommene Bild immer im Fokus ist. Andernfalls wird das Bild sofort aufgenommen, unabhängig davon, ob das Bild im Fokus ist. Das Verhalten bei der Behandlung eines fehlerhaften Fokuss und die Angabe, ob ein Timeout erforderlich ist, ist für den Treiber und bis zum OEM intern.
Tabelle "Nutzungszusammenfassung"
`Scope` | Control | type |
---|---|---|
Version 1 |
Filter |
Synchron |
Zum Konfigurieren der Fokuspriorität muss die KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSPRIORITY-Eigenschafts-ID verwendet werden. Wenn die Fokuspriorität festgelegt ist, hat die Fokussierung Vorrang vor dem Bild, das aufgenommen wurde, um sicherzustellen, dass das aufgenommene Bild immer im Fokus ist. Wenn die Fokuspriorität nicht festgelegt ist, wird das Bild sofort aufgenommen, unabhängig davon, ob das Bild im Fokus war. Das Verhalten bei der Behandlung eines fehlerhaften Fokusfehlers und Timeouts werden vom OEM bestimmt und sind treiberintern.
Für die KSCAMERA_EXTENDEDPROP_HEADER werden die folgenden Flags als Werte definiert. In einem Get-Aufruf gibt der Kameratreiber seine aktuelle Fokusprioritätskonfiguration mithilfe eines dieser Flags zurück. In einem set-Aufruf legt der Kameratreiber die neue Fokusprioritätskonfiguration mithilfe eines dieser Flags fest.
#define KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_OFF 0x0000000000000000
#define KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_ON 0x0000000000000001
Hinweis Dies ist ein synchrones Steuerelement, und es sind keine Funktionen für dieses Steuerelement definiert.
Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER Strukturfelder bei Verwendung des Fokusprioritätssteuerelements.
Member | BESCHREIBUNG |
---|---|
Version |
Dies muss 1 sein, |
PinId |
Dies muss KSCAMERA_EXTENDEDPROP_FILTERSCOPE sein (0xFFFFFFFF), |
Size |
Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_VALUE) sein. |
Ergebnis |
Dies gibt die Fehlerergebnisse an, |
Funktion |
Dies muss 0 sein, |
Flags |
Dies ist ein Lese-/Schreibfeld. Dies kann eines der oben definierten KSCAMERA_EXTENDEDPROP_FOCUSPRIORITY_Xxx Flags sein. |
Anforderungen
Header |
Ksmedia.h |