KSPROPERTY_TUNER_SCAN_CAPS_S Struktur (ksmedia.h)
Die KSPROPERTY_TUNER_SCAN_CAPS_S Struktur beschreibt die Hardwarescanfunktionen eines Tuninggeräts.
Syntax
typedef struct {
KSPROPERTY Property;
BOOL fSupportsHardwareAssistedScanning;
ULONG SupportedBroadcastStandards;
PVOID GUIDBucket;
ULONG lengthofBucket;
} KSPROPERTY_TUNER_SCAN_CAPS_S, *PKSPROPERTY_TUNER_SCAN_CAPS_S;
Angehörige
Property
Gibt eine initialisierte KSPROPERTY- Struktur an, die den Eigenschaftensatz, die Eigenschaften-ID und den Anforderungstyp beschreibt.
fSupportsHardwareAssistedScanning
Ein boolescher Wert, der angibt, ob der Treiber oder die Firmware für einen Tuner hardwaregestützte Scanvorgänge unterstützt. TRUE gibt an, dass der Treiber oder die Firmware für einen Tuner hardwaregestützte Scanvorgänge unterstützt. FALSE gibt an, dass der Treiber oder die Firmware keine hardwaregestützten Scanvorgänge unterstützt.
SupportedBroadcastStandards
Die Anzahl der Übertragungsvideostandardtypen, die vom Tuninggerät unterstützt werden können. Ein Hybrid-Tuner kann mehrere Typen unterstützen.
GUIDBucket
Ein Array von GUIDs für die Netzwerktypen, die vom Tuninggerät unterstützt werden.
Basierend auf der unterstützten Nummer in SupportedBroadcastStandards, die im anfänglichen Aufruf der KSPROPERTY_TUNER_SCAN_CAPS-Eigenschaft zurückgegeben wird, weist der analoge oder digitale Tunerfilter dann ein Array von GUIDs zu. Der Treiber verwendet diesen zugewiesenen Benutzerpuffer, um alle unterstützten GUIDs im nächsten Aufruf an KSPROPERTY_TUNER_SCAN_CAPS zurückzugeben. Der Treiber muss die ProbeForWrite--Funktion aufrufen, um diesen Benutzerpuffer zu überprüfen und sicherzustellen, dass die Länge des Puffers gültig ist. Obwohl unwahrscheinlich, wenn der Treiber in einem beliebigen Thread auf diesen Puffer zugreift, sollte er den Puffer in den Kernelbereich zuordnen. Derzeit sind Scanfunktionen für die 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 eigenschaft KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS definiert. Andere Scanfunktionen zur Unterstützung anderer Übertragungsstandards (z. B. DVB-S) werden noch nicht unterstützt.
lengthofBucket
Die Anzahl der GUIDs im GUIDBucket Arrays.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen des Betriebssystems. |
| Header- | ksmedia.h (enthalten Ksmedia.h) |