KSPROPERTY_TUNER_SCAN_CAPS_S 結構 (ksmedia.h)

發行項
03/01/2024

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 陣列。

根據在初始呼叫 KSPROPERTY_TUNER_SCAN_CAPS 屬性中所傳回 SupportedBroadcastStandards 中支援的號碼，類比或數位微調器篩選器接著會配置 GUID 陣列。驅動程式會使用此配置的用戶緩衝區，在下一次呼叫KSPROPERTY_TUNER_SCAN_CAPS中傳回所有支援的 GUID。驅動程式必須呼叫 ProbeForWrite 函式來驗證此用戶緩衝區，並確保緩衝區的長度有效。雖然不太可能，如果驅動程式會在任意線程中存取這個緩衝區，它應該會將緩衝區對應到核心空間。目前已定義掃描功能以支援模擬標準。如果驅動程式支援類比，而應用程式想要啟動類比的掃描會話，則對應的功能是由 KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS 屬性所定義。其他掃描功能可支援其他廣播標準 (例如，尚不支援 DVB-S) 。

lengthofBucket

GUIDBucket 陣列中的 GUID 數目。