KSPROPERTY_PIN_PROPOSEDATAFORMAT
Клиенты используют свойство KSPROPERTY_PIN_PROPOSEDATAFORMAT , чтобы определить, поддерживают ли контакты, созданные фабрикой контактов, определенный формат данных.
Сводная таблица использования
Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
---|---|---|---|---|
Да | Да | Фильтр | KSP_PIN | KSDATAFORMAT |
Комментарии
KSPROPERTY_PIN_PROPOSEDATAFORMAT включает структуру типа KSDATAFORMAT, указывающую предлагаемый формат данных. Укажите это свойство с помощью KSP_PIN, где элемент указывает соответствующую фабрику контактов.
Использование KSPROPERTY_TYPE_GET с этим свойством позволяет звуковому драйверу предоставлять сведения о формате данных по умолчанию для контакта. KSPROPERTY_TYPE_GET необязательно реализовать для этого свойства, если драйвер не поддерживает KSEVENT_PINCAPS_FORMATCHANGE.
Фильтр KS возвращает STATUS_SUCCESS при использовании этого свойства с KSPROPERTY_TYPE_SET, можно ли задать для контактов значение или открыть с помощью предлагаемого формата данных. Если для закрепления не удается задать предлагаемый формат данных, он возвращает STATUS_NO_MATCH. При любых других сбоях возвращается соответствующая ошибка. Если драйвер поддерживает KSPROPERTY_AUDIOSIGNALPROCESSING_MODES, это свойство должно возвращать STATUS_SUCCESS, если формат поддерживается любым из режимов обработки звукового сигнала.
Использование KSPROPERTY_TYPE_SET с этим свойством фактически не изменяет формат данных. Клиенты используют KSPROPERTY_CONNECTION_DATAFORMAT для изменения формата данных. KSPROPERTY_TYPE_SET является необязательным для реализации этого свойства.
Требования
Заголовок: ks.h (включая Ks.h)