KSPROPERTY_SYSAUDIO_COMPONENT_ID

Artigo
06/15/2023

A propriedade KSPROPERTY_SYSAUDIO_COMPONENT_ID recupera a ID do componente do dispositivo de renderização de onda que o dispositivo de áudio virtual especificado usa.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Não	Filtrar	KSPROPERTY+ULONG	KSCOMPONENTID

O descritor de propriedade (dados de instância) é uma estrutura do tipo KSPROPERTY seguida por uma variável ULONG que contém uma ID de dispositivo que identifica um dispositivo de áudio virtual. Se o SysAudio enumerar n dispositivos de áudio virtual (consulte KSPROPERTY_SYSAUDIO_DEVICE_COUNT), as IDs de dispositivo válidas variam de 0 a n-1.

O valor da propriedade (dados de operação) é uma estrutura do tipo KSCOMPONENTID que especifica o fabricante, o produto e outras informações específicas do hardware sobre o dispositivo de renderização de onda que é usado pelo dispositivo de áudio virtual especificado.

Valor retornado

Uma solicitação de propriedade KSPROPERTY_SYSAUDIO_COMPONENT_ID 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

O DirectSound não se comunica diretamente com o driver de miniporto para o hardware de áudio que está por trás de cada um dos dispositivos de áudio virtual do SysAudio. Portanto, o DirectSound não pode consultar o dispositivo de renderização de ondas diretamente para obter suas informações de ID de componente. A propriedade KSPROPERTY_SYSAUDIO_COMPONENT_ID fornece um meio para o DirectSound obter essas informações indiretamente por meio do SysAudio.