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