Set di proprietà codificatore
Questa sezione descrive i set di proprietà specifici dell'API e del codificatore disponibili per i minidriver del codificatore che usano i servizi di streaming del kernel WDM in Microsoft Windows 98/Me, Windows 2000 e Windows XP e versioni successive.
La pagina di riferimento per ogni proprietà contiene una tabella con le intestazioni di colonna visualizzate di seguito.
| 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
Si tratta dell'oggetto KS a cui viene inviata la richiesta di proprietà. La destinazione per una proprietà del codificatore 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 .
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 illustrate in Proprietà, eventi e metodi KS.
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 supporto di base con le proprietà del codificatore video, vedere Proprietà KS.
Una tabella nella descrizione di ogni proprietà indica se i minidriver del codificatore video sono necessari per supportare la lettura o la scrittura della proprietà. I minidriver del codificatore video devono restituire STATUS_NOT_SUPPORTED in risposta a ottenere o impostare richieste per le proprietà non supportate dal minidriver.
La proprietà seguente imposta ogni proprietà contenente una singola proprietà che deve essere implementata dai minidriver del codificatore video. Ovvero, ogni proprietà ottiene il proprio set, quindi specificare 0 nel membro PropertyId del membro KSPROPERTY_ITEM nella struttura di KSPROPERTY_SET in base alle esigenze.
I set di proprietà seguenti appartengono all'API codec:
I set di proprietà seguenti appartengono all'API del codificatore: