KSPROPERTY_SYSAUDIO_SELECT_GRAPH
A propriedade KSPROPERTY_SYSAUDIO_SELECT_GRAPH é usada para incluir explicitamente um nó opcional no grafo que o SysAudio cria para uma instância de pino em um dispositivo de áudio virtual.
Tabela de Resumo de Uso
| Obter | Definir | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
|---|---|---|---|---|
Não |
Sim |
Filtrar |
Nenhum |
O descritor de propriedade (dados de instância) é uma estrutura do tipo SYSAUDIO_SELECT_GRAPH que especifica a propriedade, a ID do pino e a ID do nó. A propriedade é especificada por uma estrutura inserida do tipo KSPROPERTY. A ID do pino é um índice que identifica um alocador de pinos no filtro KS que encapsula o dispositivo de áudio virtual. A ID do nó é um índice que identifica um nó opcional no caminho de dados do pino especificado. Para obter mais informações, consulte a seção Comentários a seguir.
Nenhum valor de propriedade (dados de operação) é definido para essa propriedade. Especifique o ponteiro de buffer do valor da propriedade como NULL e seu tamanho como zero.
Valor retornado
Uma solicitação de propriedade KSPROPERTY_SYSAUDIO_SELECT_GRAPH retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, a solicitação retornará um erro apropriado status código.
Comentários
Normalmente, essa propriedade é usada para forçar um nó AEC no grafo de uma instância de pino.
Ao instanciar um pino de renderização no filtro para um dispositivo de áudio virtual, o SysAudio começa no pino e, por padrão, seleciona o grafo que representa o caminho mais simples por meio do filtro. Esse grafo exclui todos os nós opcionais, como controles AEC.
Você pode substituir o comportamento padrão do SysAudio enviando primeiro ao SysAudio um KSPROPERTY_SYSAUDIO_SELECT_GRAPH solicitação set-property que especifica o nó opcional que deve ser incluído no grafo. Quando SysAudio criar posteriormente a instância de pino, o grafo do pino incluirá o nó opcional que foi especificado na solicitação.
Um KSPROPERTY_SYSAUDIO_SELECT_GRAPH solicitação set-property afeta apenas as instâncias de pin criadas após a solicitação. A solicitação não tem efeito sobre nenhum pino instanciado anteriormente.
Requisitos
parâmetro |
Ksmedia.h (inclua Ksmedia.h) |