Freigeben über


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

KSPROPERTY

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

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INTERFACE_NAME

KSPROPERTY_SYSAUDIO_DEVICE_FRIENDLY_NAME