KSPROPERTY_TUNER_SCAN_CAPS_S structure (ksmedia.h)
La structure KSPROPERTY_TUNER_SCAN_CAPS_S décrit les fonctionnalités d’analyse matérielle d’un appareil de réglage.
Syntaxe
typedef struct {
KSPROPERTY Property;
BOOL fSupportsHardwareAssistedScanning;
ULONG SupportedBroadcastStandards;
PVOID GUIDBucket;
ULONG lengthofBucket;
} KSPROPERTY_TUNER_SCAN_CAPS_S, *PKSPROPERTY_TUNER_SCAN_CAPS_S;
Membres
Property
Spécifie une structure KSPROPERTY initialisée qui décrit le jeu de propriétés, l’ID de propriété et le type de demande.
fSupportsHardwareAssistedScanning
Valeur booléenne qui indique si le pilote ou le microprogramme d’un tuner prend en charge les opérations d’analyse assistée par le matériel. TRUE indique que le pilote ou le microprogramme d’un tuner prend en charge les opérations d’analyse assistée par le matériel. FALSE indique que le pilote ou le microprogramme ne prend pas en charge les opérations d’analyse assistée par le matériel.
SupportedBroadcastStandards
Nombre de types standard de vidéo de diffusion que l’appareil de réglage peut prendre en charge. Un tuner hybride peut prendre en charge plusieurs types.
GUIDBucket
Tableau de GUID pour les types de réseau pris en charge par l’appareil de réglage.
En fonction du numéro pris en charge dans SupportedBroadcastStandards retourné dans l’appel initial à la propriété KSPROPERTY_TUNER_SCAN_CAPS , le filtre de tuner analogique ou numérique alloue ensuite un tableau de GUID. Le pilote utilise cette mémoire tampon d’utilisateur allouée pour retourner tous les GUID pris en charge lors de l’appel suivant à KSPROPERTY_TUNER_SCAN_CAPS. Le pilote doit appeler la fonction ProbeForWrite pour valider cette mémoire tampon utilisateur et doit s’assurer que la longueur de la mémoire tampon est valide. Bien que peu probable, si le pilote accède à cette mémoire tampon dans un thread arbitraire, il doit mapper la mémoire tampon dans l’espace du noyau. Actuellement, les fonctionnalités d’analyse sont définies pour prendre en charge la norme analogique. Si le pilote prend en charge l’analogique et que l’application a l’intention de démarrer une session d’analyse pour l’analogique, les fonctionnalités correspondantes sont définies par la propriété KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS . Les autres fonctionnalités d’analyse permettant de prendre en charge d’autres normes de diffusion (par exemple, DVB-S) ne sont pas encore prises en charge.
lengthofBucket
Nombre de GUID dans le tableau GUIDBucket .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures du système d’exploitation. |
| En-tête | ksmedia.h (incluez Ksmedia.h) |