KSPROPERTY_TUNER_SCAN_CAPS_S struttura (ksmedia.h)

Articolo
02/26/2024

La struttura KSPROPERTY_TUNER_SCAN_CAPS_S descrive le funzionalità di analisi hardware di un dispositivo di ottimizzazione.

Sintassi

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

Members

Property

Specifica una struttura KSPROPERTY inizializzata che descrive il set di proprietà, l'ID proprietà e il tipo di richiesta.

fSupportsHardwareAssistedScanning

Valore booleano che indica se il driver o il firmware per un tuner supporta le operazioni di analisi assistita dall'hardware. TRUE indica che il driver o il firmware per un tuner supporta le operazioni di analisi assistita dall'hardware. FALSE indica che il driver o il firmware non supporta operazioni di analisi assistita dall'hardware.

SupportedBroadcastStandards

Numero di tipi standard video di trasmissione che il dispositivo di ottimizzazione può supportare. Un tuner ibrido può supportare più tipi.

GUIDBucket

Matrice di GUID per i tipi di rete supportati dal dispositivo di ottimizzazione.

In base al numero supportato in SupportedBroadcastStandards restituito nella chiamata iniziale alla proprietà KSPROPERTY_TUNER_SCAN_CAPS , il filtro di tuner analogico o digitale assegna quindi una matrice di GUID. Il driver usa questo buffer utente allocato per restituire tutti i GUID supportati nella chiamata successiva a KSPROPERTY_TUNER_SCAN_CAPS. Il driver deve chiamare la funzione ProbeForWrite per convalidare il buffer utente e deve assicurarsi che la lunghezza del buffer sia valida. Sebbene improbabile, se il driver accederà a questo buffer in un thread arbitrario, dovrebbe eseguire il mapping del buffer nello spazio del kernel. Attualmente, le funzionalità di analisi sono definite per supportare lo standard analogico. Se il driver supporta l'analogico e l'applicazione intende avviare una sessione di analisi per l'analogico, le funzionalità corrispondenti vengono definite dalla proprietà KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS . Altre funzionalità di analisi per supportare altri standard di trasmissione (ad esempio, VB-S) non sono ancora supportati.

lengthofBucket

Numero di GUID nella matrice GUIDBucket .