KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (strategia di prestazioni dell'applicazione)
I driver della fotocamera possono ottimizzare l'operazione di acquisizione in base ai suggerimenti forniti dall'applicazione. Questa proprietà informa il driver di impostare la strategia di prestazioni in base all'operazione che è probabilmente utilizzata di più. Ad esempio, quando ottimizzato per la foto, il driver della fotocamera può programmare il sensore per ottimizzare la velocità e la risoluzione dell'esposizione del sensore per ridurre la latenza dal trigger di acquisizione foto all'acquisizione di immagini. Analogamente, quando ottimizzato per il video, il driver della fotocamera può programmare il sensore per una frequenza di fotogrammi più elevata, ma a una risoluzione inferiore.
Tabella di riepilogo dell'utilizzo
| Get | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
|---|---|---|---|---|
| Sì | Sì | Filtra | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
Il valore della proprietà (dati dell'operazione) contiene una struttura KSCAMERA_EXTENDEDPROP_HEADER e una struttura KSCAMERA_EXTENDEDPROP_VALUE .
Le dimensioni totali dei dati della proprietà sono sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Il membro Size di KSCAMERA_EXTENDEDPROP_HEADER è impostato su questa dimensione totale dei dati della proprietà.
Il membro Capability di KSCAMERA_EXTENDEDPROP_HEADER contiene una combinazione OR bit per bit di uno o più degli hint di ottimizzazione seguenti.
| Hint di ottimizzazione | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO | L'operazione della fotocamera è ottimizzata per le foto |
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO | L'operazione della fotocamera è ottimizzata per il video |
Il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER contiene l'ottimizzazione attualmente impostata per la fotocamera (un valore).
Il tipo di ottimizzazione predefinito è KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO. Se questa proprietà è supportata dal driver della fotocamera, entrambi i tipi di ottimizzazione devono essere supportati.
Questo controllo proprietà è sincrono e non annullabile.
Commenti
Modalità di ottimizzazione
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO
Tutti i driver della fotocamera devono essere in questa modalità fino a quando non vengono esplicitamente informati per usare la modalità di KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO. Lo scopo di questa modalità è ottimizzare l'hardware della fotocamera per le operazioni fotografiche. Le operazioni video devono comunque essere funzionali in questa modalità.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO
Questa modalità indica che la fotocamera verrà probabilmente usata per le operazioni video. Il driver della fotocamera deve ottimizzare l'hardware per le operazioni video per questa modalità. Le operazioni di foto devono essere funzionali, ma la priorità di utilizzo delle risorse è per le operazioni video.
Recupero della proprietà
Quando 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 | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Risultato | 0 |
| Funzionalità | Valori di ottimizzazione supportati |
| Flags | Impostazione del valore di ottimizzazione corrente |
Se in precedenza non è stata impostata alcuna modalità di ottimizzazione, il driver imposta Flag su KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (impostazione predefinita).
Impostazione della proprietà
Quando la proprietà è impostata, una richiesta di KSPROPERTY_TYPE_SET, il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER conterrà la modalità di ottimizzazione da impostare.
Requisiti
Versione: Disponibile a partire da Windows 8.1
Intestazione: Ksmedia.h (include Ksmedia.h)