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)