KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE

La propiedad KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE crea un nuevo origen virtual.

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
Sí	No	Filtrar	SYSAUDIO_CREATE_VIRTUAL_SOURCE	ULONG

El descriptor de propiedad (datos de instancia) es una estructura de tipo SYSAUDIO_CREATE_VIRTUAL_SOURCE que especifica los GUID de categoría y nombre de patilla para el origen virtual.

El valor de propiedad (datos de operación) es una variable ULONG que contiene el índice de origen virtual. SysAudio genera este índice para identificar el nuevo origen virtual.

Valor devuelto

Una solicitud de propiedad KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.

Observaciones

Esta propiedad se usa para crear un origen virtual de línea de mezclador, como un volumen o un control de silenciación.

Si SysAudio ya ha creado un origen virtual con los mismos GUID de categoría de anclaje y nombre de anclaje, una solicitud get-property KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE recupera el índice del origen virtual existente. De lo contrario, la solicitud genera un nuevo índice de origen virtual y genera ese valor.

Una vez que SysAudio ha asignado un índice a un origen virtual, se puede usar una solicitudde KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCE set-property para asociar ese origen virtual a una instancia de pin en el dispositivo de audio virtual.

El usuario controla los niveles de volumen de varios orígenes de audio a través de la aplicación SndVol32. Estos orígenes incluyen el dispositivo de salida de onda, sintetizador MIDI, reproductor de CD y conector de línea. SndVol32 usa las funciones waveOutXxx, midiOutXxx y auxXxx de Windows multimedia para controlar los niveles de volumen de estos orígenes. Para obtener más información sobre las funciones multimedia de Windows, consulte la documentación de Microsoft Windows SDK.

SysAudio intercepta los cambios de volumen realizados en estos dispositivos y los aplica a sus orígenes virtuales. Por ejemplo, si un sintetizador MIDI de software que convierte un archivo MIDI en datos de onda está conectado a uno de los pines de representación de ondas del dispositivo de audio virtual, SysAudio aplica cambios de volumen midiOutXxx al pin (en lugar de cambios de volumen waveOutXxx ). Del mismo modo, si el controlador del sistema Redbook, que convierte el audio digital de un reproductor de CD a datos de onda, se conecta a uno de los pines de representación de ondas del dispositivo de audio virtual, SysAudio aplica AUXCAPS_CDAUDIO cambios de volumen en el pin. Para obtener más información sobre la estructura de AUXCAPS_CDAUDIO, consulte la documentación de Windows SDK.

Requisitos

Encabezado

Ksmedia.h (incluye Ksmedia.h)

Vea también

SYSAUDIO_CREATE_VIRTUAL_SOURCE

KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCE