estructura SYSAUDIO_INSTANCE_INFO (ksmedia.h)

  • Artículo

La estructura SYSAUDIO_INSTANCE_INFO especifica qué dispositivo de audio virtual se va a abrir e incluye marcas para configurar ese dispositivo.

Sintaxis

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

Miembros

Property

Especifica la propiedad . Este parámetro es una estructura de tipo KSPROPERTY.

Flags

Marcas que especifican cómo configurar el dispositivo de audio virtual. Actualmente, el único bit de marca definido para este parámetro es SYSAUDIO_FLAGS_DONT_COMBINE_PINS. Si se establece, este bit de marca indica a SysAudio que no combine los pines de representación. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

DeviceNumber

Especifica el identificador de dispositivo. Este miembro identifica el dispositivo de audio virtual que va a abrir la solicitud de propiedad. Si SysAudio enumera N dispositivos de audio virtual (consulte KSPROPERTY_SYSAUDIO_DEVICE_COUNT), los identificadores de dispositivo válidos van de 0 a N-1.

Comentarios

Esta estructura la usa la propiedad KSPROPERTY_SYSAUDIO_INSTANCE_INFO .

De forma predeterminada, un dispositivo de audio virtual combina sus patillas de representación de onda. La marca SYSAUDIO_FLAGS_DONT_COMBINE_PINS invalida este valor predeterminado.

Cuando se combinan patillas, el dispositivo de audio virtual expone un único generador de patillas que combina pines de representación acelerados por hardware en el dispositivo de audio con patillas mezcladoras emuladas por software en el controlador del sistema KMixer. Si los pines no se combinan, los pins acelerados por hardware y los patillas emulados por software se exponen a través de generadores de patillas independientes. Para informar correctamente del número de patillas aceleradas por hardware a los programas de aplicación, DirectSound requiere que los patillas no se combinen.

Esta propiedad es similar a KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE, con la excepción de que incluye marcas que especifican cómo configurar el dispositivo de audio virtual.

Requisitos

Requisito Valor
Header ksmedia.h (incluya Ksmedia.h)

Consulte también

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO