KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

Статья
06/15/2023

Свойство KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE указывает текущий экземпляр виртуального звукового устройства.

Сводная таблица использования

Получить	Присвойте параметру	Назначение	Тип дескриптора свойства	Тип значения свойства
Да	Да	Фильтр	KSPROPERTY	ULONG

Значение свойства (данные операции) имеет тип ULONG и указывает идентификатор виртуального звукового устройства. Если SysAudio перечисляет n виртуальных звуковых устройств (см . KSPROPERTY_SYSAUDIO_DEVICE_COUNT), допустимые идентификаторы устройств варьируются от 0 до n–1.

Возвращаемое значение

Запрос свойства KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE возвращает STATUS_SUCCESS, указывающий на успешное завершение. В противном случае запрос возвращает соответствующий код состояния ошибки.

Запрос KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE set-property открывает виртуальное звуковое устройство, указанное идентификатором устройства, содержащимся в значении свойства . Последнее открытое устройство называется текущим.

Некоторые свойства SysAudio позволяют идентифицировать текущее устройство по пустому идентификатору устройства , равному -1, а не по допустимому идентификатору устройства в диапазоне от 0 до n–1, где n — это количество доступных виртуальных звуковых устройств. К этим свойствам относятся KSPROPERTY_SYSAUDIO_DEVICE_INTERFACE_NAME и KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME.

Запрос get-property извлекает идентификатор текущего (последнего открытого) виртуального звукового устройства.