KSPROPERTY_SYSAUDIO_SELECT_GRAPH
La propriété KSPROPERTY_SYSAUDIO_SELECT_GRAPH est utilisée pour inclure explicitement un nœud facultatif dans le graphe généré par SysAudio pour une broche instance sur un périphérique audio virtuel.
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Non |
Oui |
Filtrer |
None |
Le descripteur de propriété (instance données) est une structure de type SYSAUDIO_SELECT_GRAPH qui spécifie la propriété, l’ID d’épingle et l’ID de nœud. La propriété est spécifiée par une structure incorporée de type KSPROPERTY. L’ID de broche est un index identifiant une fabrique de broches dans le filtre KS qui encapsule le périphérique audio virtuel. L’ID de nœud est un index identifiant un nœud facultatif dans le chemin de données de la broche spécifiée. Pour plus d'informations, consultez la section Notes qui suit.
Aucune valeur de propriété (données d’opération) n’est définie pour cette propriété. Spécifiez le pointeur de la mémoire tampon de la valeur de propriété sur NULL et sa taille sur zéro.
Valeur de retour
Une demande de propriété KSPROPERTY_SYSAUDIO_SELECT_GRAPH retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la requête retourne une erreur appropriée status code.
Notes
Cette propriété est généralement utilisée pour forcer un nœud AEC dans le graphique pour une broche instance.
Lors de l’instanciation d’une broche de rendu sur le filtre d’un périphérique audio virtuel, SysAudio démarre à l’épingle et sélectionne par défaut le graphique qui représente le chemin d’accès le plus simple dans le filtre. Ce graphique exclut les nœuds facultatifs tels que les contrôles AEC.
Vous pouvez remplacer le comportement par défaut de SysAudio en envoyant d’abord à SysAudio une requête KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property qui spécifie le nœud facultatif à inclure dans le graphique. Lorsque SysAudio crée ensuite la broche instance, le graphe de la broche inclut le nœud facultatif qui a été spécifié dans la requête.
Une requête KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property affecte uniquement les instances d’épingle créées après la demande. La requête n’a aucun effet sur les broches précédemment instanciées.
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |