Set di proprietà minidriver di acquisizione video
Questa sezione descrive i set di proprietà specifici dell'acquisizione video disponibili per i minidriver di acquisizione video che usano i servizi di streaming kernel WDM in Microsoft Windows XP, Windows 2000 e Windows 98/Me e i sistemi operativi successivi.
La pagina di riferimento per ogni proprietà contiene una tabella con le intestazioni di colonna seguenti.
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
Queste intestazioni hanno i significati seguenti:
Recupero
L'oggetto KS di destinazione supporta la richiesta di proprietà KSPROPERTY_TYPE_GET?
Set
L'oggetto KS di destinazione supporta la richiesta di proprietà KSPROPERTY_TYPE_SET?
Destinazione
La destinazione è l'oggetto KS a cui viene inviata la richiesta di proprietà. La destinazione per una proprietà di acquisizione video è un filtro o un pin. La richiesta di proprietà specifica l'oggetto di destinazione tramite il relativo handle del kernel.
Tipo di descrittore delle proprietà
Il descrittore della proprietà specifica la proprietà e l'operazione da eseguire su tale proprietà. Il descrittore inizia sempre con una struttura KSPROPERTY , ma alcuni tipi di descrittore contengono informazioni aggiuntive. Ad esempio, la struttura KSNODEPROPERTY è un descrittore di proprietà che inizia con una struttura KSPROPERTY, ma include anche un identificatore di nodo.
Tipo di valore della proprietà
Una proprietà ha un valore e il tipo di questo valore dipende dalla proprietà. Ad esempio, una proprietà che può trovarsi in uno solo di due stati-on o off-in genere ha un valore BOOL. Proprietà che può presupporre valori interi da 0x0 a 0xFFFFFFFF potrebbe avere un valore ULONG. Le proprietà più complesse potrebbero avere valori che sono matrici o strutture.
Il descrittore della proprietà e il valore della proprietà precedente sono le versioni specifiche della proprietà dei buffer di dati e delle specifiche dell'istanza che KS Properties, Events e Metodi illustrano.
Una richiesta di proprietà usa uno dei flag seguenti per specificare l'operazione da eseguire nella proprietà:
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Tutti gli oggetti filtro e pin supportano l'operazione di supporto di base sulle relative proprietà. Se supportano le operazioni get e Set dipendono dalla proprietà . Una proprietà che rappresenta una funzionalità intrinseca dell'oggetto filtro o pin è probabile che richieda solo un'operazione di recupero. Una proprietà che rappresenta un'impostazione configurabile potrebbe richiedere solo un'operazione Set , anche se un'operazione get potrebbe essere utile anche per la lettura dell'impostazione corrente. Per altre informazioni sull'uso delle operazioni get, set e basic-support con proprietà di acquisizione video, vedere Proprietà KS.
Ogni descrizione della proprietà contiene una tabella che indica se i minidriver di acquisizione video devono supportare la lettura o la scrittura della proprietà. I minidriver di acquisizione video devono restituire STATUS_NOT_SUPPORTED in risposta a ottenere o impostare richieste per le proprietà non supportate dal minidriver.
L'elenco seguente descrive i set di proprietà di streaming kernel usati dai minidriver di acquisizione video:
PROPSETID_VIDCAP_CAMERACONTROL
KSPROPERTYSETID_ExtendedCameraControl
PROPSETID_VIDCAP_DROPPEDFRAMES
PROPSETID_VIDCAP_VIDEOCOMPRESSION
I set di proprietà seguenti possono essere usati con il driver di classe video USB:
PROPSETID_VIDCAP_CAMERACONTROL