структура 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 (include Ksmedia.h) |