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_Acoustic_Echo_Cancel
KSPROPSETID_DirectSound3DBuffer