KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE
KSPROPERTY_CAMERACONTROL_EXTENDED_FRAMERATE_THROTTLE è un controllo dinamico che riduce la frequenza dei fotogrammi del video in base a un fattore di scala della frequenza dei fotogrammi originale.
Tabella di riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo descrittore di proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
| Sì | Sì | Filtro | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
Il valore della proprietà (dati dell'operazione) contiene una struttura KSCAMERA_EXTENDEDPROP_HEADER e una struttura KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING.
Le dimensioni totali dei dati della proprietà sono sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING). Il membro Size di KSCAMERA_EXTENDEDPROP_HEADER è impostato sulle dimensioni totali dei dati delle proprietà.
Il membro Capability di KSCAMERA_EXTENDEDPROP_HEADER contiene uno dei valori seguenti.
| Controllo della limitazione della frequenza dei fotogrammi | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF | La limitazione della frequenza dei fotogrammi è disabilitata. |
| KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON | La limitazione della frequenza dei fotogrammi è abilitata. |
Il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER contiene il flag attualmente impostato per la fotocamera. KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF deve essere l'impostazione predefinita.
Questo controllo proprietà è sincrono e non annullabile.
Questo controllo si applica solo mentre la fotocamera è in streaming attivo. Per essere attivamente in streaming, significa che un pin di anteprima o di record deve essere in KSSTATE_RUN, pronto e in grado di distribuire fotogrammi. In un set se un flusso non è attivo, questo controllo deve restituire STATUS_INVALID_DEVICE_STATE. Anche se si tratta di un controllo Ambito filtro, questo non dovrebbe influire su flussi foto-pin o non RGB, ad esempio IR/depth.
Osservazioni:
Ottenere la proprietà
Quando si risponde a una richiesta di KSPROPERTY_TYPE_GET, il driver imposta i membri del KSCAMERA_EXTENDEDPROP_HEADER su quanto segue.
| Membro | Valore |
|---|---|
| Versione | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Dimensione | Deve essere sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING) |
| Risultato | Deve essere 0. Questo campo viene utilizzato per restituire il risultato dell'ultima operazione edizione Standard T. |
| Funzionalità | KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON o 0x1 |
| Flag | Può essere KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_ON o KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF. |
Se in precedenza non è stato impostato alcun flag di limitazione della frequenza dei fotogrammi, il driver imposta Flag su KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF. I membri della struttura KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING che segue KSCAMERA_EXTENDEDPROP_HEADER vengono impostati in base ai requisiti della modalità di limitazione della frequenza dei fotogrammi.
Impostare la proprietà
Quando la proprietà è impostata, una richiesta KSPROPERTY_TYPE_edizione Standard T, il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER contiene la modalità di limitazione della frequenza dei fotogrammi da impostare. Il membro VideoProc.Value di KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING deve essere ignorato quando Flags contiene il flag KSCAMERA_EXTENDEDPROP_FRAMERATE_THROTTLE_OFF.
Struttura del payload
La tabella seguente contiene le descrizioni e i requisiti per i campi della struttura KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING per l'oggetto DDI della limitazione della frequenza dei fotogrammi. Questa struttura è definita in ksmedia.h.
| Membro | Descrizione |
|---|---|
| Modalità | È inutilizzato e deve essere 0. |
| Min/Max/Step | Il valore Max deve essere 100, che indica che non viene modificata la frequenza dei fotogrammi. Il passaggio deve essere un fattore pari a 100 in modo che max % step == 0. Min deve essere uguale ad almeno una dimensione di passaggio o a un multiplo delle dimensioni del passaggio. Min non può essere 0. |
| VideoProc | VideoProc.Value.ul deve specificare la percentuale del fattore di scala per questo controllo. Questo valore deve essere compreso nell'intervallo di Min e Max e deve essere impostato su un multiplo del valore Step. Impostando questo valore in modo appropriato, un'applicazione può assicurarsi che la nuova frequenza dei fotogrammi non superi mai il valore originale, né andare a zero. Ad esempio, l'impostazione di un valore pari a 80 produrrebbe una frequenza di fotogrammi pari all'80% della frequenza dei fotogrammi originale. |
| Prenotato | Questa operazione non è usata. Questa operazione deve essere ignorata dal driver. |
Requisiti
Client minimo supportato: Windows 11, versione 24H2
Intestazione: ksmedia.h (include Ksmedia.h)