структура KSPROPERTY_TUNER_SCAN_CAPS_S (ksmedia.h)
Структура KSPROPERTY_TUNER_SCAN_CAPS_S описывает возможности аппаратного сканирования устройства настройки.
Синтаксис
typedef struct {
KSPROPERTY Property;
BOOL fSupportsHardwareAssistedScanning;
ULONG SupportedBroadcastStandards;
PVOID GUIDBucket;
ULONG lengthofBucket;
} KSPROPERTY_TUNER_SCAN_CAPS_S, *PKSPROPERTY_TUNER_SCAN_CAPS_S;
Члены
Property
Задает инициализированную структуру KSPROPERTY , которая описывает набор свойств, идентификатор свойства и тип запроса.
fSupportsHardwareAssistedScanning
Логическое значение, указывающее, поддерживает ли драйвер или встроенное ПО для тюнера операции аппаратного сканирования. ЗНАЧЕНИЕ TRUE указывает, что драйвер или встроенное ПО для тюнера поддерживает аппаратные операции сканирования. False указывает, что драйвер или встроенное ПО не поддерживают аппаратные операции сканирования.
SupportedBroadcastStandards
Количество стандартных типов видеотрансляций, которые может поддерживать устройство настройки. Гибридный тюнер может поддерживать несколько типов.
GUIDBucket
Массив идентификаторов GUID для типов сети, поддерживаемых устройством настройки.
На основе поддерживаемого числа в SupportedBroadcastStandards , возвращаемого при первоначальном вызове свойства KSPROPERTY_TUNER_SCAN_CAPS , аналоговый или цифровой фильтр тюнера выделяет массив идентификаторов GUID. Драйвер использует выделенный буфер пользователя для возврата всех поддерживаемых идентификаторов GUID в следующем вызове KSPROPERTY_TUNER_SCAN_CAPS. Драйвер должен вызвать функцию ProbeForWrite для проверки этого пользовательского буфера и убедиться, что длина буфера является допустимой. Хотя маловероятно, если драйвер получит доступ к этому буферу в произвольном потоке, он должен сопоставить буфер с пространством ядра. В настоящее время возможности сканирования определены для поддержки аналогового стандарта. Если драйвер поддерживает аналог и приложение намерено запустить сеанс сканирования аналога, соответствующие возможности определяются свойством KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS . Другие возможности сканирования для поддержки других стандартов вещания (например, DVB-S) пока не поддерживаются.
lengthofBucket
Число идентификаторов GUID в массиве GUIDBucket .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционной системы. |
| Верхняя часть | ksmedia.h (включая Ksmedia.h) |