Set di proprietà driver audio
Questa sezione descrive i set di proprietà specifici dell'audio disponibili per i driver audio che usano servizi di streaming kernel WDM in Microsoft Windows 2000 e versioni successive e in Windows Millennium Edition (Me) e Windows 98.
La pagina di riferimento per ogni proprietà contiene una tabella con le intestazioni di colonna seguenti.
| Get | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
|---|---|---|---|---|
Queste intestazioni hanno i significati seguenti:
Recupero
L'oggetto KS di destinazione supporta la richiesta di proprietà KSPROPERTY_TYPE_GET? Specificare sì o no.
Set
L'oggetto KS di destinazione supporta la richiesta di proprietà KSPROPERTY_TYPE_SET? Specificare sì o no.
Destinazione
La destinazione per la richiesta è l'oggetto KS a cui viene inviata la richiesta di proprietà. La destinazione per una proprietà audio è un filtro o un pin. La richiesta di proprietà specifica l'oggetto di destinazione dal relativo handle kernel.
Tipo descrittore di proprietà
Il descrittore di 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 ID nodo.
Tipo valore proprietà
Una proprietà ha in genere un valore e il tipo di questo valore dipende dalla proprietà . Ad esempio, una proprietà che può trovarsi in uno dei soli due stati,on o off,in genere ha un valore BOOL. Una proprietà che può presupporre valori interi compresi tra 0 e 0xFFFFFFFF potrebbe avere un valore ULONG. Le proprietà più complesse possono avere valori che sono matrici o strutture.
Il descrittore e il valore della proprietà precedenti sono le versioni specifiche della proprietà dei buffer instance-specification e operation-data descritti in Proprietà KS, Eventi e Metodi.
Una richiesta di proprietà usa uno dei flag seguenti per specificare l'operazione da eseguire sulla 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à. L'eventuale supporto delle operazioni get e set dipende dalla proprietà . È probabile che una proprietà che rappresenta una funzionalità intrinseca dell'oggetto filtro o pin richieda solo un'operazione get. 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à audio, vedere Endpoint audio, proprietà ed eventi.
I set di proprietà seguenti sono definiti per i driver audio:
KSPROPSETID_Acoustic_Echo_Cancel
KSPROPSETID_DirectSound3DBuffer