KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE
KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE es un control dinámico que reduce la velocidad de fotogramas del vídeo por un factor de escala de la velocidad de fotogramas original.
Tabla de resumen de uso
| Obtener Yammer | Establecer | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
| Sí | Sí | Filtro | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
El valor de propiedad (datos de operación) contiene una estructura KSCAMERA_EXTENDEDPROP_HEADER y una estructura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING.
El tamaño total de los datos de propiedad es sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). El miembro Size de KSCAMERA_EXTENDEDPROP_HEADER se establece en este tamaño total de datos de propiedad.
El miembro Capability de KSCAMERA_EXTENDEDPROP_HEADER contiene uno de los valores siguientes.
| Control de limitación de la velocidad de fotogramas | Descripción |
|---|---|
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF | La limitación de velocidad de fotogramas está deshabilitada. |
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON | La limitación de velocidad de fotogramas está habilitada. |
El miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contiene la marca establecida actualmente para la cámara. KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF debe ser el valor predeterminado.
Este control de propiedad es sincrónico y no cancelable.
Este control solo se aplica mientras la cámara está transmitiendo activamente. Para transmitir activamente significa que un pin de vista previa o grabación debe estar en KSSTATE_RUN, listo y capaz de entregar fotogramas. En un conjunto si una secuencia no está activa, este control debe devolver STATUS_INVALID_DEVICE_STATE. Incluso cuando se trata de un control de ámbito filtro, esto no debería afectar a las secuencias de pin de foto o no de RGB, como IR/profundidad.
Comentarios
Obtención de la propiedad
Al responder a una solicitud KSPROPERTY_TYPE_GET, el controlador establece los miembros de KSCAMERA_EXTENDEDPROP_HEADER en lo siguiente.
| Miembro | Valor |
|---|---|
| Versión | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Size | Debe ser sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING) |
| Resultado | Debe ser 0. Este campo se usa para devolver el resultado de la última operación SET. |
| Funcionalidad | KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON o 0x1 |
| Flags | Esto puede ser KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON o KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF. |
Si no se estableció previamente ninguna marca de limitación de velocidad de fotogramas, el controlador establece Flags en KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF. Los miembros de la estructura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING que sigue a KSCAMERA_EXTENDEDPROP_HEADER se establecen según los requisitos del modo de limitación de la velocidad de fotogramas.
Establecimiento de la propiedad
Cuando se establece la propiedad, una solicitud de KSPROPERTY_TYPE_SET, el miembro Flags de KSCAMERA_EXTENDEDPROP_HEADER contiene el modo de limitación de la velocidad de fotogramas que se va a establecer. El miembro VideoProc.Value de KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING debe omitirse cuando Flags contiene la marca KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF.
Estructura de la carga útil
La tabla siguiente contiene las descripciones y los requisitos de los campos de la estructura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING para el DDI de la limitación de la velocidad de fotogramas. Esta estructura se define en ksmedia.h.
| Miembro | Descripción |
|---|---|
| Mode | Esto no se usa y debe ser 0. |
| Min/Max/Step | Max debe ser 100, lo que indica ningún cambio en la velocidad de fotogramas. Step debe ser un factor de 100, de modo que Max % step == 0. Min debe ser igual a al menos un tamaño de paso o un múltiplo del tamaño del paso. Min no puede ser 0. |
| VideoProc | VideoProc.Value.ul debe especificar el porcentaje de factor de escala para este control. Este valor debe estar dentro del intervalo mínimo y máximo, y debe establecerse en un múltiplo del valor de paso. Al establecer este valor adecuadamente una aplicación puede asegurarse de que la nueva velocidad de fotogramas nunca supere el valor original, ni sea cero. Por ejemplo, establecer un valor de 80 produciría una velocidad de fotogramas del 80 % de la velocidad de fotogramas original. |
| Reserved | Esto no se usa. El controlador debe omitir esto. |
Requisitos
Cliente mínimo admitido: Windows 11, versión 24H2
Encabezado: ksmedia.h (incluya Ksmedia.h)