estructura KSPROPERTY_TUNER_SCAN_CAPS_S (ksmedia.h)

Artículo
08/07/2023

La estructura KSPROPERTY_TUNER_SCAN_CAPS_S describe las funcionalidades de examen de hardware de un dispositivo de optimización.

Sintaxis

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

Miembros

Property

Especifica una estructura KSPROPERTY inicializada que describe el conjunto de propiedades, el identificador de propiedad y el tipo de solicitud.

fSupportsHardwareAssistedScanning

Valor booleano que indica si el controlador o firmware de un tuner admite operaciones de análisis asistidos por hardware. TRUE indica que el controlador o firmware de un tuner admite operaciones de análisis asistidos por hardware. FALSE indica que el controlador o firmware no admite operaciones de análisis asistidos por hardware.

SupportedBroadcastStandards

El número de tipos estándar de vídeo de difusión que el dispositivo de optimización puede admitir. Un tuner híbrido puede admitir varios tipos.

GUIDBucket

Matriz de GUID para los tipos de red que admite el dispositivo de optimización.

Según el número admitido en SupportedBroadcastStandards que se devuelve en la llamada inicial a la propiedad KSPROPERTY_TUNER_SCAN_CAPS , el filtro de tuner analógico o digital asigna una matriz de GUID. El controlador usa este búfer de usuario asignado para devolver todos los GUID admitidos en la siguiente llamada a KSPROPERTY_TUNER_SCAN_CAPS. El controlador debe llamar a la función ProbeForWrite para validar este búfer de usuario y debe asegurarse de que la longitud del búfer es válida. Aunque es poco probable que el controlador acceda a este búfer en un subproceso arbitrario, debe asignar el búfer al espacio del kernel. Actualmente, las funcionalidades de examen se definen para admitir el estándar analógico. Si el controlador admite analógico y la aplicación pretende iniciar una sesión de examen para analógico, las funcionalidades correspondientes se definen mediante la propiedad KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS . Todavía no se admiten otras funcionalidades de examen para admitir otros estándares de difusión (por ejemplo, DVB-S).

lengthofBucket

Número de GUID de la matriz GUIDBucket .