KSPROPERTY_TUNER_FREQUENCY_S structure (ksmedia.h)

The KSPROPERTY_TUNER_FREQUENCY_S structure describes the frequency of a TV or radio tuner device.

Syntax

typedef struct {
  KSPROPERTY Property;
  ULONG      Frequency;
  ULONG      LastFrequency;
  ULONG      TuningFlags;
  ULONG      VideoSubChannel;
  ULONG      AudioSubChannel;
  ULONG      Channel;
  ULONG      Country;
} KSPROPERTY_TUNER_FREQUENCY_S, *PKSPROPERTY_TUNER_FREQUENCY_S;

Members

Property

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

Frequency

Specifies the frequency of the tuner. If the request is a Get request, the minidriver returns the current frequency of the tuner. If the request is a Set request, the minidriver should set the frequency of the tuner to the specified value. This value is specified in hertz (Hz).

LastFrequency

Specifies the last frequency tuned.

TuningFlags

Specifies tuning flags that describe the granularity of a tuning operation. If the request is a Get request, the minidriver returns the current tuning flags. If the request is a Set request, the minidriver should use the specified tuning method. This member must be set to one of the values from the KS_TUNER_TUNING_FLAGS enumeration.

VideoSubChannel

Specifies the video subchannel of a digital television source. If the request is a Get request, the minidriver should return the video subchannel for the digital television source to the specified value. If the request is a Set request, the minidriver should set the video subchannel for the digital television source. This member is only used by devices that support the DSS tuner mode (KSPROPERTY_TUNER_MODE_DSS).

AudioSubChannel

Specifies the audio subchannel of a digital television source. If the request is a Get request, the minidriver should return the audio subchannel for the digital television source. If the request is a Set request, the minidriver should set the audio subchannel for the digital television source. This member is only used by devices that support the DSS tuner mode (KSPROPERTY_TUNER_MODE_DSS).

Channel

Specifies the video subchannel of a digital television source. If the request is a Get request, the minidriver should return the video subchannel for the digital television source to the specified value. If the request is a Set request, the minidriver should set the video subchannel for the digital television source. This member is only used by devices that support the DSS tuner mode (KSPROPERTY_TUNER_MODE_DSS).

Country

Specifies the current country code for the tuning operation. Country codes follow the Telephony API (TAPI) region code values that correspond to the international long distance dialing codes.

Requirements

Requirement Value
Header ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY

KSPROPERTY_TUNER_FREQUENCY

KS_TUNER_TUNING_FLAGS

PROPSETID_TUNER