Compartilhar via


Conjuntos de propriedades de drivers de áudio

Esta seção descreve os conjuntos de propriedades específicos de áudio que estão disponíveis para drivers de áudio que usam serviços de streaming de kernel WDM no Microsoft Windows 2000 e posterior e no Windows Millennium Edition (Eu) e Windows 98.

A página de referência de cada propriedade contém uma tabela com os títulos de coluna a seguir.

Get Set Destino Tipo de descritor de propriedade Tipo de valor da propriedade

Esses títulos têm os seguintes significados:

  • Get

    O objeto KS de destino dá suporte à solicitação de propriedade KSPROPERTY_TYPE_GET? (Especifique sim ou não.)

  • Configurar

    O objeto KS de destino dá suporte à solicitação de propriedade KSPROPERTY_TYPE_SET? (Especifique sim ou não.)

  • Target (destino)

    O destino da solicitação é o objeto KS para o qual a solicitação de propriedade é enviada. O destino de uma propriedade de áudio é um filtro ou um pino. (A solicitação de propriedade especifica o objeto de destino por seu identificador de kernel.)

  • Tipo de descritor de propriedade

    O descritor de propriedade especifica a propriedade e a operação a serem executadas nessa propriedade. O descritor sempre começa com uma estrutura KSPROPERTY , mas alguns tipos de descritor contêm informações adicionais. Por exemplo, a estrutura KSNODEPROPERTY é um descritor de propriedade que começa com uma estrutura KSPROPERTY, mas também inclui uma ID de nó.

  • Tipo de valor da propriedade

    Uma propriedade normalmente tem um valor e o tipo desse valor depende da propriedade . Por exemplo, uma propriedade que pode estar em um dos dois únicos estados – ativado ou desativado – normalmente tem um valor BOOL. Uma propriedade que pode assumir valores inteiros de 0 a 0xFFFFFFFF pode ter um valor ULONG. Propriedades mais complexas podem ter valores que são matrizes ou estruturas.

O descritor de propriedade anterior e o valor da propriedade são as versões específicas da propriedade dos buffers de especificação de instância e de dados de operação discutidos em Propriedades, Eventos e Métodos do KS.

Uma solicitação de propriedade usa um dos seguintes sinalizadores para especificar a operação que deve ser executada na propriedade :

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

Todos os objetos de filtro e fixação dão suporte à operação de suporte básico em suas propriedades. Se eles dão suporte às operações get e set depende da propriedade . Uma propriedade que representa uma funcionalidade inerente do objeto de filtro ou pino provavelmente exigirá apenas uma operação get. Uma propriedade que representa uma configuração configurável pode exigir apenas uma operação de conjunto, embora uma operação get também possa ser útil para ler a configuração atual. Para obter mais informações sobre como usar as operações get, set e basic-support com propriedades de áudio, consulte Pontos de extremidade de áudio, propriedades e eventos.

Os seguintes conjuntos de propriedades são definidos para drivers de áudio:

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