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 |
---|---|---|---|---|
Sí |
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_SYSAUDIO_DEVICE_COUNT