KSPROPERTY_TUNER_SCAN_CAPS_S structure (ksmedia.h)

The KSPROPERTY_TUNER_SCAN_CAPS_S structure describes the hardware scanning capabilities of a tuning device.

Syntax

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

Members

Property

Specifies an initialized KSPROPERTY structure that describes the property set, property ID, and request type.

fSupportsHardwareAssistedScanning

A Boolean value that indicates whether the driver or firmware for a tuner supports hardware-assisted scanning operations. TRUE indicates that the driver or firmware for a tuner supports hardware-assisted scanning operations. FALSE indicates that the driver or firmware does not support hardware-assisted scanning operations.

SupportedBroadcastStandards

The number of broadcast video standard types that the tuning device can support. A hybrid tuner can support multiple types.

GUIDBucket

An array of GUIDs for the network types that the tuning device supports.

Based on the supported number in SupportedBroadcastStandards that is returned in the initial call to the KSPROPERTY_TUNER_SCAN_CAPS property, the analog or digital tuner filter then allocates an array of GUIDs. The driver uses this allocated user buffer to return all the supported GUIDs in the next call to KSPROPERTY_TUNER_SCAN_CAPS. The driver must call the ProbeForWrite function to validate this user buffer and must ensure that the length of the buffer is valid. Although unlikely, if the driver will access this buffer in an arbitrary thread, it should map the buffer into kernel space. Currently, scanning capabilities are defined for supporting the analog standard. If the driver supports analog and the application intends to start a scanning session for analog, the corresponding capabilities are defined by the KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS property. Other scanning capabilities to support other broadcast standards (for example, DVB-S) are not yet supported.

lengthofBucket

The number of GUIDs in the GUIDBucket array.

Requirements

See also

KSPROPERTY

KSPROPERTY_TUNER_NETWORKTYPE_SCAN_CAPS

KSPROPERTY_TUNER_SCAN_CAPS

PROPSETID_TUNER