KSPROPERTY_SYSAUDIO_SELECT_GRAPH
La propiedad KSPROPERTY_SYSAUDIO_SELECT_GRAPH se usa para incluir explícitamente un nodo opcional en el gráfico que SysAudio compila para una instancia de pin en un dispositivo de audio virtual.
Tabla de resumen de uso
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
No |
Sí |
Filtrar |
Ninguno |
El descriptor de propiedad (datos de instancia) es una estructura de tipo SYSAUDIO_SELECT_GRAPH que especifica la propiedad, el identificador de anclaje y el identificador de nodo. La propiedad se especifica mediante una estructura incrustada de tipo KSPROPERTY. El identificador de patilla es un índice que identifica un generador de patillas en el filtro KS que encapsula el dispositivo de audio virtual. El identificador de nodo es un índice que identifica un nodo opcional en la ruta de acceso de datos del pin especificado. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
No se define ningún valor de propiedad (datos de operación) para esta propiedad. Especifique el puntero de búfer del valor de propiedad como NULL y su tamaño como cero.
Valor devuelto
Una solicitud de propiedad KSPROPERTY_SYSAUDIO_SELECT_GRAPH devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.
Observaciones
Esta propiedad se usa normalmente para forzar un nodo AEC en el gráfico para una instancia de pin.
Al crear una instancia de un pin de representación en el filtro de un dispositivo de audio virtual, SysAudio comienza en el pin y, de forma predeterminada, selecciona el gráfico que representa la ruta de acceso más sencilla a través del filtro. Este grafo excluye los nodos opcionales, como los controles AEC.
Puede invalidar el comportamiento predeterminado de SysAudio enviando primero a SysAudio una solicitud de KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property que especifica el nodo opcional que se va a incluir en el gráfico. Cuando SysAudio crea posteriormente la instancia de pin, el gráfico del pin incluirá el nodo opcional que se especificó en la solicitud.
Una solicitud de KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property afecta solo a las instancias de anclaje que se crean después de la solicitud. La solicitud no tiene ningún efecto en las patillas con instancias anteriores.
Requisitos
Encabezado |
Ksmedia.h (incluye Ksmedia.h) |