Compartilhar via


KSPROPERTY_PIN_PROPOSEDATAFORMAT

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.

Requisitos

Cabeçalho: ks.h (inclua Ks.h)

Confira também

KSP_PIN

KSDATAFORMAT

KSEVENT_PINCAPS_FORMATCHANGE

Propriedades do KS

KSPROPERTY

KSPROPERTY_AUDIOSIGNALPROCESSING_MODES