Share via

IScanningTunerEx::GetTunerScanningCapability

  • Article
 
Microsoft DirectShow 9.0

IScanningTunerEx::GetTunerScanningCapability

This topic applies to Windows Vista.

The GetTunerScanningCapability method retrieves the set of broadcast standards supported by the tuner and the tuner's scanning capability.

Syntax

  HRESULT GetTunerScanningCapability(
    long *
  HardwareAssistedScanning
  ,
    long *
  NumStandardsSupported
  ,
    GUID *
  BroadcastStandards

  );

Parameters

HardwareAssistedScanning

[out]  Receives a Boolean value. If the value is TRUE, the scanning algorithm is implemented entirely by the tuner hardware. Otherwise, the tuner filter implements part of the scanning algorithm in software.

NumStandardsSupported

[out]  Receives the number of broadcast standards supported by the tuner.

BroadcastStandards

[out]  Pointer to an array of GUIDs. The array must be large enough to hold a number of elements equal to the value returned in the NumStandardsSupported parameter. To find the required array size, call the method once and set this parameter to NULL. Then allocate the array and call the method again, setting this parameter to the address of the array.

Return Values

When the method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.

Remarks

The following broadcast standard GUIDs are defined in Bdamedia.h.

GUID Description
ANALOG_AUXIN_NETWORK_TYPE Auxiliary video input
ANALOG_FM_NETWORK_TYPE FM radio tuner
ANALOG_TV_NETWORK_TYPE Analog television
DIGITAL_CABLE_NETWORK_TYPE Digital cable

Requirements

Header: Include Tuner.h.

See Also