KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME
Die eigenschaft KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME ruft eine Unicode-Zeichenfolge ab, die den Anzeigenamen des virtuellen Audiogeräts enthält.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Nein |
Filter |
KSPROPERTY+ULONG |
LPWSTR |
Der Eigenschaftendeskriptor (instance Daten) besteht aus einer KSPROPERTY-Struktur gefolgt von einer ULONG-Variablen, die eine Geräte-ID enthält, die ein virtuelles Audiogerät identifiziert. Wenn SysAudio n virtuelle Audiogeräte aufzählt (siehe KSPROPERTY_SYSAUDIO_DEVICE_COUNT), reichen gültige Geräte-IDs von 0 bis n-1. Außerdem kann der Geräte-ID-Wert -1 verwendet werden, um das aktuelle Gerät anzugeben, das das letzte virtuelle Audiogerät ist, das von einer KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE - oder KSPROPERTY_SYSAUDIO_INSTANCE_INFOSet-Property-Anforderung geöffnet wurde.
Der Eigenschaftswert (Vorgangsdaten) ist ein Zeiger auf eine Zeichenfolge mit NULL-Beendigung von Unicode-Zeichen, die den Anzeigenamen des Geräts enthält.
Rückgabewert
Eine KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen geeigneten Fehler status Code zurück.
Anforderungen
Header |
Ksmedia.h (einschließlich Ksmedia.h) |
Siehe auch
KSPROPERTY_SYSAUDIO_DEVICE_COUNT