ksmedia.h) (KSPROPERTY_TUNER_SCAN_CAPS_S 结构

项目
08/07/2023

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

指定描述属性集、属性 ID 和请求类型的已初始化 KSPROPERTY 结构。

fSupportsHardwareAssistedScanning

一个布尔值，指示调谐器的驱动程序或固件是否支持硬件辅助扫描操作。 TRUE 表示调谐器的驱动程序或固件支持硬件辅助扫描操作。 FALSE 表示驱动程序或固件不支持硬件辅助扫描操作。

SupportedBroadcastStandards

优化设备可以支持的广播视频标准类型的数量。混合调谐器可以支持多种类型。

GUIDBucket

优化设备支持的网络类型的 GUID 数组。

根据初始调用 KSPROPERTY_TUNER_SCAN_CAPS 属性时返回的 SupportedBroadcastStandards 中支持的数字，模拟或数字调谐器筛选器随后分配 GUID 数组。驱动程序使用此分配的用户缓冲区在下次调用 KSPROPERTY_TUNER_SCAN_CAPS 时返回所有受支持的 GUID。驱动程序必须调用 ProbeForWrite 函数来验证此用户缓冲区，并且必须确保缓冲区的长度有效。尽管不太可能，但如果驱动程序将在任意线程中访问此缓冲区，它应将缓冲区映射到内核空间中。目前，定义扫描功能是为了支持模拟标准。如果驱动程序支持模拟，并且应用程序打算启动模拟扫描会话，则相应的功能由 KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS 属性定义。尚不支持其他支持其他广播标准的扫描功能 (例如 DVB-S) 。

lengthofBucket

GUIDBucket 数组中的 GUID 数。