KSPROPERTY_SYSAUDIO_DEVICE_COUNT
La propiedad KSPROPERTY_SYSAUDIO_DEVICE_COUNT recupera un recuento que especifica el número de dispositivos de audio virtual entre los que tiene que elegir un programa de aplicación de DirectSound.
Tabla de resumen de uso
Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
---|---|---|---|---|
Sí |
No |
Filtrar |
ULONG |
El valor de propiedad (datos de operación) es una variable ULONG en la que SysAudio escribe un recuento que especifica el número de dispositivos de audio virtual entre los que elegir. Si SysAudio enumera n dispositivos de audio virtual, estos dispositivos se identifican mediante identificadores de dispositivo 0 a n-1.
Valor devuelto
Una solicitud de propiedad KSPROPERTY_SYSAUDIO_DEVICE_COUNT 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
SysAudio enumera un dispositivo de audio virtual único para cada dispositivo de hardware habilitado en el sistema que realiza la representación de onda. En cada instancia, el dispositivo de audio virtual se compone del dispositivo de hardware, el controlador del sistema KMixer y otros componentes de audio. Un programa de aplicación directSound selecciona un dispositivo de hardware determinado seleccionando el dispositivo de audio virtual que incorpora el dispositivo de hardware.
Por ejemplo, si hay tres tarjetas de audio conectadas al bus del sistema y cada una contiene un dispositivo de representación de onda con un controlador de miniporte WaveCíclico o WavePci, SysAudio enumera tres dispositivos de audio virtual con identificadores de dispositivo 0, 1 y 2.
SysAudio mantiene su lista de dispositivos de audio virtual en el registro del sistema en la categoría KSCATEGORY_AUDIO_DEVICE. Esta categoría está reservada exclusivamente para su uso por SysAudio. DirectSound no accede directamente a la información sobre los dispositivos de audio virtual desde el registro del sistema. En su lugar, consulta SysAudio para las propiedades de los dispositivos de audio virtual.
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |