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
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the operating system. |
| Header | ksmedia.h (include Ksmedia.h) |