Condividi tramite


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_AC3

KSPROPSETID_Acoustic_Echo_Cancel

KSPROPSETID_Audio

KSPROPSETID_AudioEngine

KSPROPSETID_AudioGfx

KSPROPSETID_AudioLoopback

KSPROPSETID_AudioModule

KSPROPSETID_BtAudioModule

KSPROPSETID_DirectSound3DBuffer

KSPROPSETID_DirectSound3DListener

KSPROPSETID_DrmAudioStream

KSPROPSETID_FMRXControl

KSPROPSETID_FMRXTopology

KSPROPSETID_Hrtf3d

KSPROPSETID_Itd3d

KSPROPSETID_Jack

KSPROPSETID_RTAudio

KSPROPSETID_SoundDetector

KSPROPSETID_SoundDetector2

KSPROPSETID_Synth

KSPROPSETID_SynthClock

KSPROPSETID_Synth_Dls

KSPROPSETID_Sysaudio

KSPROPSETID_Sysaudio_Pin

KSPROPSETID_TelephonyControl

KSPROPSETID_TelephonyTopology

KSPROPSETID_TopologyNode