Compartilhar via

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

  • Artigo

A propriedade KSPROPERTY_SYSAUDIO_DEVICE_COUNT recupera uma contagem que especifica o número de dispositivos de áudio virtual que um programa de aplicativo DirectSound precisa escolher.

Tabela de Resumo de Uso

Obter Definir Destino Tipo de descritor de propriedade Tipo de valor da propriedade

Sim

Não

Filtrar

KSPROPERTY

ULONG

O valor da propriedade (dados de operação) é uma variável ULONG na qual SysAudio grava uma contagem especificando o número de dispositivos de áudio virtual a serem escolhidos. Se o SysAudio enumerar n dispositivos de áudio virtual, esses dispositivos serão identificados por IDs de dispositivo 0 a n-1.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_SYSAUDIO_DEVICE_COUNT retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.

Comentários

O SysAudio enumera um dispositivo de áudio virtual exclusivo para cada dispositivo de hardware habilitado no sistema que executa a renderização de ondas. Em cada instância, o dispositivo de áudio virtual é composto pelo dispositivo de hardware, pelo driver do sistema KMixer e por outros componentes de áudio. Um programa de aplicativo DirectSound seleciona um dispositivo de hardware específico selecionando o dispositivo de áudio virtual que incorpora o dispositivo de hardware.

Por exemplo, se três placas de áudio estiverem conectadas ao barramento do sistema e cada uma contiver um dispositivo de renderização de onda com um driver de miniporte WaveCyclic ou WavePci, o SysAudio enumera três dispositivos de áudio virtual com as IDs de dispositivo 0, 1 e 2.

O SysAudio mantém sua lista de dispositivos de áudio virtual no registro do sistema na categoria KSCATEGORY_AUDIO_DEVICE. Essa categoria é reservada exclusivamente para uso pelo SysAudio. O DirectSound não acessa diretamente informações sobre os dispositivos de áudio virtual do registro do sistema. Em vez disso, ele consulta o SysAudio para obter as propriedades dos dispositivos de áudio virtual.

Requisitos

parâmetro

 Ksmedia.h (inclua Ksmedia.h)

Confira também

KSPROPERTY