KSPROPERTY_TUNER_SCAN_CAPS_S-Struktur (ksmedia.h)

Die KSPROPERTY_TUNER_SCAN_CAPS_S-Struktur beschreibt die Hardwarescanfunktionen eines Optimierungsgeräts.

Syntax

typedef struct {
  KSPROPERTY Property;
  BOOL       fSupportsHardwareAssistedScanning;
  ULONG      SupportedBroadcastStandards;
  PVOID      GUIDBucket;
  ULONG      lengthofBucket;
} KSPROPERTY_TUNER_SCAN_CAPS_S, *PKSPROPERTY_TUNER_SCAN_CAPS_S;

Member

Property

Gibt eine initialisierte KSPROPERTY-Struktur an, die den Eigenschaftensatz, die Eigenschafts-ID und den Anforderungstyp beschreibt.

fSupportsHardwareAssistedScanning

Ein boolescher Wert, der angibt, ob der Treiber oder die Firmware für einen Tuner hardwareunterstützte Scanvorgänge unterstützt. TRUE gibt an, dass der Treiber oder die Firmware für einen Tuner hardwareunterstützte Scanvorgänge unterstützt. FALSE gibt an, dass der Treiber oder die Firmware keine hardwareunterstützten Scanvorgänge unterstützt.

SupportedBroadcastStandards

Die Anzahl der Broadcast-Videostandardtypen, die das Optimierungsgerät unterstützen kann. Ein Hybridtuner kann mehrere Typen unterstützen.

GUIDBucket

Ein Array von GUIDs für die Netzwerktypen, die vom Optimierungsgerät unterstützt werden.

Basierend auf der unterstützten Nummer in SupportedBroadcastStandards , die beim ersten Aufruf der KSPROPERTY_TUNER_SCAN_CAPS-Eigenschaft zurückgegeben wird, ordnet der analoge oder digitale Tunerfilter dann ein Array von GUIDs zu. Der Treiber verwendet diesen zugeordneten Benutzerpuffer, um alle unterstützten GUIDs im nächsten Aufruf von KSPROPERTY_TUNER_SCAN_CAPS zurückzugeben. Der Treiber muss die Funktion ProbeForWrite aufrufen, um diesen Benutzerpuffer zu überprüfen, und muss sicherstellen, dass die Länge des Puffers gültig ist. Wenn der Treiber in einem beliebigen Thread auf diesen Puffer zugreift, sollte er den Puffer dem Kernelbereich zuordnen. Derzeit sind Scanfunktionen zur Unterstützung des analogen Standards definiert. Wenn der Treiber analog unterstützt und die Anwendung beabsichtigt, eine Scansitzung für analog zu starten, werden die entsprechenden Funktionen durch die KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS-Eigenschaft definiert. Andere Scanfunktionen zur Unterstützung anderer Broadcaststandards (z. B. DVB-S) werden noch nicht unterstützt.

lengthofBucket

Die Anzahl der GUIDs im GUIDBucket-Array .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen des Betriebssystems.
Kopfzeile	ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSPROPERTY

KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS

KSPROPERTY_TUNER_SCAN_CAPS

PROPSETID_TUNER