структура 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)

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

KSPROPERTY

KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS

KSPROPERTY_TUNER_SCAN_CAPS

PROPSETID_TUNER