structure KSPROPERTY_TUNER_SCAN_CAPS_S (ksmedia.h)
La structure KSPROPERTY_TUNER_SCAN_CAPS_S décrit les fonctionnalités d’analyse matérielle d’un appareil de paramétrage.
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 de KSPROPERTY initialisée qui décrit le jeu de propriétés, l’ID de propriété et le type de requête.
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 diffusion vidéo que l’appareil de paramétrage 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 paramétrage.
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 réglage 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 dans l’appel suivant à KSPROPERTY_TUNER_SCAN_CAPS. Le pilote doit appeler la fonction ProbeForWrite pour valider cette mémoire tampon utilisateur et 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 analogique, les fonctionnalités correspondantes sont définies par la propriété KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS. D’autres fonctionnalités d’analyse pour 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures du système d’exploitation. |
| d’en-tête | ksmedia.h (include Ksmedia.h) |