KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

Questa proprietà fornisce la frequenza massima dei fotogrammi di acquisizione per una fotocamera quando si trova in modalità sequenza di foto.

Tabella riepilogo utilizzo

Get	Set	Destinazione	Tipo di descrittore delle proprietà	Tipo di valore della proprietà
Sì	Sì	Aggiungi (Blocca)	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

Il valore della proprietà (dati operazione) contiene una struttura KSCAMERA_EXTENDEDPROP_HEADER e una struttura KSCAMERA_EXTENDEDPROP_VALUE . La frequenza massima dei fotogrammi in fotogrammi al secondo viene impostata o restituita come valore in KSCAMERA_EXTENDEDPROP_VALUE.

Non sono presenti flag impostati nel membro Flag di KSCAMERA_EXTENDEDPROP_HEADER per questa proprietà.

Le dimensioni totali dei dati delle proprietà sono sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Il membro Size di KSCAMERA_EXTENDEDPROP_HEADER è impostato su questa dimensione totale dei dati delle proprietà.

Questo controllo proprietà è asincrono e non annullabile.

Commenti

Quando si risponde a una richiesta di KSPROPERTY_TYPE_GET, il driver imposta i membri del KSCAMERA_EXTENDEDPROP_HEADER al seguente.

Membro	Valore
Versione	1
PinId	ID pin per il pin della foto.
Dimensione	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Risultato	Valore di errore risultante dal tentativo di leggere la frequenza massima dei fotogrammi. Altrimenti, è impostato su 0.
Funzionalità	KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Flags	0

Il valore della frequenza dei fotogrammi è impostato nel membro Ratio di KSCAMERA_EXTENDEDPROP_VALUE. Ratio.HighPart contiene il numeratore della frequenza dei fotogrammi e Ratio.LowPart contiene il denominatore della frequenza dei fotogrammi.

Quando il driver è in modalità sequenza foto, potrebbe essere necessario limitare la frequenza massima di fotogrammi dell'acquisizione di foto. Si tratta di garantire che gli scenari di acquisizione "moment in time", con un determinato numero di fotogrammi di cronologia, siano contenuti in un intervallo di tempo configurato. Ad esempio, in base ai vincoli di memoria, se l'applicazione vuole acquisire 1 secondo di cronologia precedente, è necessario limitare la frequenza di acquisizione in modo che sia necessario solo il numero N di fotogrammi.

Se impostato, il driver deve usare la frequenza dei fotogrammi fornita anche se la fotocamera può acquisire fotogrammi rapidamente, la frequenza richiesta. Se necessario, il driver può eliminare fotogrammi aggiuntivi per soddisfare la frequenza richiesta.

L'impostazione del valore massimo della frequenza dei fotogrammi su 0 (0 per HighPart e 0 per LowPart of the Ratio) cancella l'impostazione massima della frequenza dei fotogrammi nel driver e ha lo stesso effetto di chiedere al driver di fornire fotogrammi il più velocemente possibile. Una volta impostata la frequenza dei fotogrammi su 0, qualsiasi query successiva restituirà il valore della frequenza massima di fotogrammi possibile per il driver della fotocamera.

Requisiti

Versione	Disponibile a partire da Windows 8.1.
Intestazione	Ksmedia.h (includere Ksmedia.h)