estrutura SYSAUDIO_INSTANCE_INFO (ksmedia.h)

Artigo
02/29/2024

A estrutura SYSAUDIO_INSTANCE_INFO especifica qual dispositivo de áudio virtual abrir e inclui sinalizadores para configurar esse dispositivo.

Sintaxe

typedef struct {
  KSPROPERTY Property;
  ULONG      Flags;
  ULONG      DeviceNumber;
} SYSAUDIO_INSTANCE_INFO, *PSYSAUDIO_INSTANCE_INFO;

Membros

Property

Especifica a propriedade . Esse parâmetro é uma estrutura do tipo KSPROPERTY.

Flags

Sinalizadores que especificam como configurar o dispositivo de áudio virtual. Atualmente, o único bit de sinalizador definido para esse parâmetro é SYSAUDIO_FLAGS_DONT_COMBINE_PINS. Se definido, esse bit de sinalizador instrui SysAudio a não combinar pinos de renderização. Para obter mais informações, consulte a seção Comentários a seguir.

DeviceNumber

Especifica a ID do dispositivo. Esse membro identifica o dispositivo de áudio virtual que deve ser aberto pela solicitação de propriedade. Se o SysAudio enumerar N dispositivos de áudio virtual (consulte KSPROPERTY_SYSAUDIO_DEVICE_COUNT), as IDs de dispositivo válidas variam de 0 a N-1.

Comentários

Essa estrutura é usada pela propriedade KSPROPERTY_SYSAUDIO_INSTANCE_INFO .

Por padrão, um dispositivo de áudio virtual combina seus pinos de renderização de onda. O sinalizador SYSAUDIO_FLAGS_DONT_COMBINE_PINS substitui esse padrão.

Quando os pinos são combinados, o dispositivo de áudio virtual expõe uma única fábrica de pinos que combina pinos de renderização acelerada por hardware no dispositivo de áudio com pinos de mixer emulados por software no driver do sistema KMixer. Se os pinos não forem combinados, os pinos acelerados por hardware e os pinos emulados por software serão expostos por meio de fábricas de pinos separadas. Para relatar corretamente o número de pinos acelerados por hardware para programas de aplicativo, o DirectSound exige que os pinos não sejam combinados.

Essa propriedade é semelhante a KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE, com a exceção de que ela inclui sinalizadores especificando como configurar o dispositivo de áudio virtual.