KSPROPERTY_TUNER_STATUS_S 구조체(ksmedia.h)

아티클
03/18/2023

KSPROPERTY_TUNER_STATUS_S 구조는 현재 튜닝 빈도를 포함하여 TV 및 라디오 튜너 디바이스에 대한 튜닝 작업의 진행률을 설명합니다.

구문

typedef struct {
  KSPROPERTY Property;
  ULONG      CurrentFrequency;
  ULONG      PLLOffset;
  ULONG      SignalStrength;
  ULONG      Busy;
} KSPROPERTY_TUNER_STATUS_S, *PKSPROPERTY_TUNER_STATUS_S;

멤버

Property

속성 집합, 속성 ID 및 요청 형식을 설명하는 초기화된 KSPROPERTY 구조를 지정합니다.

CurrentFrequency

현재 튜너 빈도를 지정합니다. 이 값은 헤르츠(Hz)에 있습니다.

PLLOffset

튜닝 세분성의 배수에서 PLL(위상 잠금 루프) 오프셋을 지정합니다. 이는 튜너 전략이 KS_TUNER_STRATEGY_PLL 경우에 사용됩니다. 튜너 전략이 KS_TUNER_STRATEGY_PLL 않으면 이 값은 의미가 없습니다. 다음 표에서는 튜닝 세분성이 62.5kHz라고 가정하여 다양한 튜닝 조건에 대해 미니드라이버에서 반환할 값을 보여 줍니다.

빈도 오프셋	PLLOffset
+125,000	+2
+62,500	+1
완벽하게 조정됨	0
-62,500	-1
-125,000	-2

SignalStrength

신호의 진폭을 지정합니다. 이는 튜너 전략이 KS_TUNER_STRATEGY_SIGNAL_STRENGTH 경우에 사용됩니다. 미니 드라이버에서 지원하는 튜닝 전략에 관계없이 이 멤버의 유효한 값은 다음과 같습니다.

값	의미
-1	강도를 사용할 수 없습니다.
0	허용 가능한 빈도가 아닙니다.
1	허용 가능한 빈도입니다.

Busy

미니드라이버가 현재 튜닝 프로세스로 사용 중인지 여부를 나타냅니다. 미니드라이버가 현재 채널을 조정하는 경우 이 멤버를 TRUE 로 설정해야 합니다. 그렇지 않으면 미니드라이버가 현재 새 채널로 조정되지 않는 경우 이 멤버를 FALSE로 설정해야 합니다.