KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

Artículo
06/15/2023

La propiedad KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE especifica la instancia actual de un dispositivo de audio virtual.

Tabla de resumen de uso

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

El valor de propiedad (datos de operación) es de tipo ULONG y especifica el identificador de dispositivo de un dispositivo de audio virtual. 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.

Valor devuelto

Una solicitud de propiedad KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE 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

Una solicitud de KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE set-property abre el dispositivo de audio virtual especificado por el identificador de dispositivo contenido en el valor de propiedad. El último dispositivo que se va a abrir se conoce como el dispositivo actual.

Algunas propiedades de SysAudio permiten identificar el dispositivo actual mediante un identificador de dispositivo nulo de -1 en lugar de un identificador de dispositivo válido en el intervalo de 0 a n-1, donde n es el número de dispositivos de audio virtual disponibles. Estas propiedades incluyen KSPROPERTY_SYSAUDIO_DEVICE_INTERFACE_NAME y KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME.

Una solicitud get-property recupera el identificador de dispositivo del dispositivo de audio virtual actual (abierto por última vez).