KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

Esta propiedad proporciona la velocidad máxima de fotogramas de captura para una cámara cuando se encuentra en modo de secuencia de fotos.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	Sí	Anclar	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

El valor de propiedad (datos de operación) contiene una estructura de KSCAMERA_EXTENDEDPROP_HEADER y una estructura de KSCAMERA_EXTENDEDPROP_VALUE . La velocidad máxima de fotogramas de fotos en fotogramas por segundo se establece o se devuelve como valor en KSCAMERA_EXTENDEDPROP_VALUE.

No hay marcas establecidas en el miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER para esta propiedad.

El tamaño total de los datos de propiedad es sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). El miembro Size de KSCAMERA_EXTENDEDPROP_HEADER se establece en este tamaño total de datos de propiedad.

Este control de propiedad es asincrónico y no se puede cancelar.

Comentarios

Al responder a una solicitud de KSPROPERTY_TYPE_GET, el controlador establece los miembros del KSCAMERA_EXTENDEDPROP_HEADER en lo siguiente.

Miembro	Valor
Versión	1
PinId	Identificador de patilla para el pin de foto.
Size	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Resultado	Valor de error resultante del intento de leer la velocidad máxima de fotogramas. De lo contrario, es 0.
Capacidad	KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Marcas	0

El valor de velocidad de fotogramas se establece en el miembro Ratio de KSCAMERA_EXTENDEDPROP_VALUE. Ratio.HighPart contiene el numerador de la velocidad de fotogramas y Ratio.LowPart contiene el denominador de la velocidad de fotogramas.

Cuando el controlador está en modo de secuencia de fotos, puede ser necesario limitar la velocidad de fotogramas máxima de la captura de fotos. Esto es para asegurarse de que los escenarios de captura de "momentos en tiempo", con un determinado número de fotogramas del historial, se encuentran dentro de un intervalo de tiempo configurado. Por ejemplo, en función de las restricciones de memoria, si la aplicación desea capturar 1 segundo de historial pasado, es necesario limitar la velocidad de captura, por lo que solo se necesitan N números de fotogramas.

Cuando se establece, el controlador debe usar la velocidad de fotogramas proporcionada incluso si la cámara puede capturar fotogramas rápidamente, la velocidad solicitada. Si es necesario, el controlador puede soltar fotogramas adicionales para acomodar la tarifa solicitada.

Si se establece el valor máximo de velocidad de fotogramas en 0 (0 para HighPart y 0 para lowPart de la relación), se borra la configuración máxima de velocidad de fotogramas en el controlador y tiene el mismo efecto que pedir al controlador que proporcione fotogramas lo más rápido posible. Una vez establecida la velocidad de fotogramas en 0, cualquier consulta posterior devolverá el valor de la velocidad de fotogramas máxima posible para el controlador de cámara.

Requisitos

Versión	Disponible a partir de Windows 8.1.
Encabezado	Ksmedia.h (incluye Ksmedia.h)