KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE
Die KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE-Eigenschaft gibt die aktuelle instance eines virtuellen Audiogeräts an.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftsdeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Ja |
Filter |
ULONG |
Der Eigenschaftswert (Vorgangsdaten) ist vom Typ ULONG und gibt die Geräte-ID eines virtuellen Audiogeräts an. Wenn SysAudio n virtuelle Audiogeräte aufzählt (siehe KSPROPERTY_SYSAUDIO_DEVICE_COUNT), reichen die gültigen Geräte-IDs von 0 bis n-1.
Rückgabewert
Eine KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen entsprechenden Fehler status Code zurück.
Bemerkungen
Eine KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE Set-Eigenschaftsanforderung öffnet das virtuelle Audiogerät, das durch die im Eigenschaftswert enthaltene Geräte-ID angegeben wird. Das letzte Gerät, das geöffnet werden soll, wird als aktuelles Gerät bezeichnet.
Einige SysAudio-Eigenschaften ermöglichen es, dass das aktuelle Gerät durch eine NULL-Geräte-ID von -1 und nicht durch eine gültige Geräte-ID im Bereich von 0 bis n-1 identifiziert wird, wobei n die Anzahl der verfügbaren virtuellen Audiogeräte ist. Zu diesen Eigenschaften gehören KSPROPERTY_SYSAUDIO_DEVICE_INTERFACE_NAME und KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME.
Eine Get-Property-Anforderung ruft die Geräte-ID des aktuellen (zuletzt geöffneten) virtuellen Audiogeräts ab.
Anforderungen
Header |
Ksmedia.h (include Ksmedia.h) |
Siehe auch
KSPROPERTY_SYSAUDIO_DEVICE_COUNT