KSPROPERTY_PIN_PROPOSEDATAFORMAT

Artigo
06/15/2023

Os clientes usam a propriedade KSPROPERTY_PIN_PROPOSEDATAFORMAT para determinar se os pinos instanciados pelo pin factory dão suporte a um formato de dados específico.

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Sim	Filtrar	KSP_PIN	KSDATAFORMAT

Comentários

KSPROPERTY_PIN_PROPOSEDATAFORMAT inclui uma estrutura do tipo KSDATAFORMAT, especificando o formato de dados proposto. Especifique essa propriedade usando KSP_PIN, em que o membro especifica a fábrica de pinos relevante.

Usar KSPROPERTY_TYPE_GET com essa propriedade permite que o driver de áudio forneça informações sobre o formato de dados padrão em um pin. KSPROPERTY_TYPE_GET é opcional para implementar para essa propriedade, a menos que o driver dê suporte a KSEVENT_PINCAPS_FORMATCHANGE.

O filtro KS retorna STATUS_SUCCESS ao usar essa propriedade com KSPROPERTY_TYPE_SET se os pinos puderem ser definidos como ou abertos com o formato de dados proposto. Se o pino não puder ser definido como o formato de dados proposto, ele retornará STATUS_NO_MATCH. Para quaisquer outras falhas, um erro apropriado é retornado. Se o driver der suporte a KSPROPERTY_AUDIOSIGNALPROCESSING_MODES, essa propriedade deverá retornar STATUS_SUCCESS se o formato for compatível com qualquer um dos modos de processamento de sinal de áudio.

Usar KSPROPERTY_TYPE_SET com essa propriedade não altera o formato de dados. Os clientes usam KSPROPERTY_CONNECTION_DATAFORMAT para alterar o formato de dados. KSPROPERTY_TYPE_SET é opcional para implementar para essa propriedade.