KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE
La proprietà KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE crea una nuova origine virtuale.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
Sì |
No |
Filtra |
ULONG |
Il descrittore di proprietà (dati dell'istanza) è una struttura di tipo SYSAUDIO_CREATE_VIRTUAL_SOURCE che specifica i GUID pin-category e pin-name per l'origine virtuale.
Il valore della proprietà (dati operazione) è una variabile ULONG contenente l'indice di origine virtuale. SysAudio genera questo indice per identificare la nuova origine virtuale.
Valore restituito
Una richiesta di proprietà KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.
Commenti
Questa proprietà viene usata per creare un'origine virtuale line di mixer, ad esempio un controllo volume o mute.
Se SysAudio ha già creato un'origine virtuale con gli stessi GUID pin-category e pin-name, una richiesta di KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE get-property recupera l'indice per l'origine virtuale esistente. In caso contrario, la richiesta genera un nuovo indice di origine virtuale e restituisce tale valore.
Dopo che SysAudio ha assegnato un indice a un'origine virtuale, è possibile usare una richiesta diKSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCE proprietà set-property per collegare tale origine virtuale a un'istanza di pin nel dispositivo audio virtuale.
L'utente controlla i livelli di volume di varie origini audio tramite l'applicazione SndVol32. Queste origini includono il dispositivo wave-output, il sintetizzatore MIDI, il lettore CD e il jack line-in. SndVol32 usa le funzioni waveOut xxx multimediale di Windows, midiOutXxx e auxXxx per controllare i livelli di volume per queste origini. Per altre informazioni sulle funzioni multimediali di Windows, vedere la documentazione di Microsoft Windows SDK.
SysAudio intercetta le modifiche del volume apportate a questi dispositivi e le applica alle relative origini virtuali. Ad esempio, se un sintetizzatore MIDI software che converte un file MIDI in dati wave è connesso a uno dei pin di rendering onda del dispositivo virtuale, SysAudio applica le modifiche del volume midiOutXxx al pin (anziché modificare il volume waveOutXxx ). Analogamente, se il driver di sistema Redbook, che converte l'audio digitale da un lettore CD ai dati wave, è connesso a uno dei pin di rendering onda del dispositivo virtuale, SysAudio applica AUXCAPS_CDAUDIO modifiche al volume. Per altre informazioni sulla struttura AUXCAPS_CDAUDIO, vedere la documentazione di Windows SDK.
Requisiti
Intestazione |
Ksmedia.h (includere Ksmedia.h) |