KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME
La proprietà KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME recupera una stringa Unicode contenente il nome descrittivo del dispositivo audio virtuale.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
|---|---|---|---|---|
Sì |
No |
Filtra |
KSPROPERTY+ULONG |
LPWSTR |
Il descrittore di proprietà (dati dell'istanza) è costituito da una struttura KSPROPERTY seguita da una variabile ULONG contenente un ID dispositivo che identifica un dispositivo audio virtuale. Se SysAudio enumera n dispositivi audio virtuali (vedere KSPROPERTY_SYSAUDIO_DEVICE_COUNT), gli ID dispositivo validi vanno da 0 a n-1. Inoltre, è possibile usare il valore -1 dell'ID dispositivo per indicare il dispositivo corrente, ovvero l'ultimo dispositivo audio virtuale aperto da una richiesta di KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE o di KSPROPERTY_SYSAUDIO_INSTANCE_INFOset-property.
Il valore della proprietà (dati dell'operazione) è un puntatore a una stringa con terminazione Null di caratteri Unicode che contiene il nome descrittivo del dispositivo.
Valore restituito
Una richiesta di proprietà KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.
Requisiti
Intestazione |
Ksmedia.h (include Ksmedia.h) |
Vedere anche
KSPROPERTY_SYSAUDIO_DEVICE_COUNT