Compartir a través de


KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME

La propiedad KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME recupera una cadena Unicode que contiene el nombre descriptivo del dispositivo de audio virtual.

Tabla de resumen de uso

Obtener Set Destino Tipo de descriptor de propiedad Tipo de valor de propiedad

No

Filtrar

KSPROPERTY+ULONG

LPWSTR

El descriptor de propiedad (datos de instancia) consta de una estructura KSPROPERTY seguida de una variable ULONG que contiene un identificador de dispositivo que identifica 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. Además, se puede usar un valor de identificador de dispositivo de -1 para indicar el dispositivo actual, que es el último dispositivo de audio virtual abierto por una solicitud de KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE o KSPROPERTY_SYSAUDIO_INSTANCE_INFOset-property.

El valor de propiedad (datos de operación) es un puntero a una cadena terminada en null de caracteres Unicode que contiene el nombre descriptivo del dispositivo.

Valor devuelto

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

Requisitos

Encabezado

Ksmedia.h (incluye Ksmedia.h)

Vea también

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO