KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOTHUMBNAIL
Questa proprietà ottiene o imposta la funzionalità di anteprima per la fotocamera. Se viene fornito un fattore di ridimensionamento, le anteprime vengono abilitate sulla scala selezionata.
Tabella riepilogo utilizzo
| Get | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
|---|---|---|---|---|
Sì |
Sì |
Aggiungi (Blocca) |
Il valore della proprietà (dati dell'operazione) contiene una struttura KSCAMERA_EXTENDEDPROP_HEADER e una struttura KSCAMERA_EXTENDEDPROP_VALUE . Il KSCAMERA_EXTENDEDPROP_VALUE è obbligatorio, ma il membro Value viene ignorato.
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ù dei valori di scala seguenti supportati.
| Contrassegno di scala anteprima | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_DISABLE | Le anteprime sono disabilitate. |
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_2X | La risoluzione dell'anteprima è X/2 e Y/2. |
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_2X | La risoluzione dell'anteprima è X/4 e Y/4. |
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_8X | La risoluzione dell'anteprima è X/8 e Y/8. |
| KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_16X | La risoluzione dell'anteprima è X/16 e Y/16. |
Il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER contiene il valore della scala di anteprima attualmente impostato per la fotocamera. Se la generazione di anteprime non è abilitata, solo KSCAMERA_EXTENDEDPROP_PHOTOTHUMBNAIL_DISABLE è impostata in Flag.
Questo controllo proprietà è asincrono e non annullabile.
Commenti
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 | ID del segnaposto per la foto. |
| Dimensione | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Risultato | Valore di errore risultante dal tentativo di ottenere le impostazioni di anteprima. |
| Funzionalità | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (valori di scala di anteprima supportati). |
| Flags | Impostazione del valore di anteprima corrente (un solo valore). |
Impostazione della proprietà
Quando la proprietà è impostata, una richiesta di KSPROPERTY_TYPE_SET, il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER conterrà uno dei flag di scala dell'anteprima.
Requisiti
Versione |
Disponibile a partire da Windows 8.1. |
Intestazione |
Ksmedia.h (include Ksmedia.h) |