KSPROPERTY_SYSAUDIO_SELECT_GRAPH
La proprietà KSPROPERTY_SYSAUDIO_SELECT_GRAPH viene usata per includere in modo esplicito un nodo facoltativo nel grafico compilato da SysAudio per un'istanza di pin in un dispositivo audio virtuale.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
No |
Sì |
Filtra |
Nessuno |
Il descrittore di proprietà (dati dell'istanza) è una struttura di tipo SYSAUDIO_SELECT_GRAPH che specifica la proprietà, l'ID pin e l'ID nodo. La proprietà viene specificata da una struttura incorporata di tipo KSPROPERTY. L'ID pin è un indice che identifica una factory di pin nel filtro KS che esegue il wrapping del dispositivo audio virtuale. L'ID del nodo è un indice che identifica un nodo facoltativo nel percorso dati del pin specificato. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Per questa proprietà non viene definito alcun valore di proprietà (dati dell'operazione). Specificare il puntatore del buffer del valore della proprietà come NULL e le relative dimensioni come zero.
Valore restituito
Una richiesta di proprietà KSPROPERTY_SYSAUDIO_SELECT_GRAPH 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 in genere usata per forzare un nodo AEC nel grafico per un'istanza di pin.
Quando si crea un'istanza di un pin di rendering sul filtro per un dispositivo audio virtuale, SysAudio inizia al pin e per impostazione predefinita seleziona il grafico che rappresenta il percorso più semplice tramite il filtro. Questo grafico esclude tutti i nodi facoltativi, ad esempio controlli AEC.
È possibile eseguire l'override del comportamento predefinito di SysAudio inviando prima sysAudio a KSPROPERTY_SYSAUDIO_SELECT_GRAPH una richiesta set-property che specifica il nodo facoltativo da includere nel grafico. Quando SysAudio crea successivamente l'istanza del pin, il grafico del pin includerà il nodo facoltativo specificato nella richiesta.
Una richiesta di KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property influisce solo sulle istanze del pin create dopo la richiesta. La richiesta non ha alcun effetto sui pin creata in precedenza.
Requisiti
Intestazione |
Ksmedia.h (includere Ksmedia.h) |