Condividi tramite


KSPROPERTY_SYSAUDIO_DEVICE_COUNT

La proprietà KSPROPERTY_SYSAUDIO_DEVICE_COUNT recupera un conteggio che specifica il numero di dispositivi audio virtuali da scegliere da un programma applicazione DirectSound.

Tabella riepilogo utilizzo

Recupero Set Destinazione Tipo di descrittore delle proprietà Tipo di valore della proprietà

No

Filtra

KSPROPERTY

ULONG

Il valore della proprietà (dati operazione) è una variabile ULONG in cui SysAudio scrive un conteggio che specifica il numero di dispositivi audio virtuali da scegliere. Se SysAudio enumera n dispositivi audio virtuali, questi dispositivi vengono identificati da ID dispositivo 0 a n-1.

Valore restituito

Una richiesta di proprietà KSPROPERTY_SYSAUDIO_DEVICE_COUNT restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.

Commenti

SysAudio enumera un dispositivo audio virtuale univoco per ogni dispositivo hardware abilitato nel sistema che esegue il rendering delle onde. In ogni istanza, il dispositivo audio virtuale è costituito dal dispositivo hardware, dal driver di sistema KMixer e da altri componenti audio. Un programma applicazione DirectSound seleziona un dispositivo hardware specifico selezionando il dispositivo audio virtuale che incorpora il dispositivo hardware.

Ad esempio, se tre schede audio sono collegate al bus di sistema e ognuna contiene un dispositivo di rendering wave con un driver WaveCyclic o WavePci miniport, SysAudio enumera tre dispositivi audio virtuali con ID dispositivo 0, 1 e 2.

SysAudio mantiene l'elenco dei dispositivi audio virtuali nel Registro di sistema nella categoria KSCATEGORY_AUDIO_DEVICE. Questa categoria è riservata esclusivamente per l'uso da SysAudio. DirectSound non accede direttamente alle informazioni sui dispositivi audio virtuali dal Registro di sistema. Esegue invece una query su SysAudio per le proprietà dei dispositivi audio virtuali.

Requisiti

Intestazione

Ksmedia.h (includere Ksmedia.h)

Vedere anche

KSPROPERTY