KSPROPERTY_SYSAUDIO_DEVICE_COUNT

Die eigenschaft KSPROPERTY_SYSAUDIO_DEVICE_COUNT ruft eine Anzahl ab, die die Anzahl der virtuellen Audiogeräte angibt, aus denen ein DirectSound-Anwendungsprogramm auswählen muss.

Nutzungszusammenfassungstabelle

Der Eigenschaftswert (Vorgangsdaten) ist eine ULONG-Variable, in die SysAudio eine Anzahl schreibt, die die Anzahl der virtuellen Audiogeräte angibt, aus denen sie auswählen können. Wenn SysAudio n virtuelle Audiogeräte aufzählt, werden diese Geräte durch die Geräte-IDs 0 bis n-1 identifiziert.

Rückgabewert

Eine KSPROPERTY_SYSAUDIO_DEVICE_COUNT-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen geeigneten Fehler status Code zurück.

Bemerkungen

SysAudio listet ein eindeutiges virtuelles Audiogerät für jedes aktivierte Hardwaregerät im System auf, das Wellenrendering ausführt. In jedem instance besteht das virtuelle Audiogerät aus dem Hardwaregerät, dem KMixer-Systemtreiber und anderen Audiokomponenten. Ein DirectSound-Anwendungsprogramm wählt ein bestimmtes Hardwaregerät aus, indem das virtuelle Audiogerät ausgewählt wird, das das Hardwaregerät enthält.

Wenn beispielsweise drei Audiokarten an den Systembus angeschlossen sind und jede ein Wellenrenderinggerät mit einem WaveCyclic- oder WavePci-Miniporttreiber enthält, zählt SysAudio drei virtuelle Audiogeräte mit den Geräte-IDs 0, 1 und 2 auf.

SysAudio verwaltet die Liste der virtuellen Audiogeräte in der Systemregistrierung unter der Kategorie KSCATEGORY_AUDIO_DEVICE. Diese Kategorie ist ausschließlich für die Verwendung durch SysAudio reserviert. DirectSound greift nicht direkt aus der Systemregistrierung auf Informationen zu den virtuellen Audiogeräten zu. Stattdessen fragt es SysAudio nach den Eigenschaften der virtuellen Audiogeräte ab.

Anforderungen

Siehe auch

KSPROPERTY