Поделиться через


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)

См. также раздел

KSP_PIN

KSDATAFORMAT

KSEVENT_PINCAPS_FORMATCHANGE

Свойства KS

KSPROPERTY

KSPROPERTY_AUDIOSIGNALPROCESSING_MODES