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) |