KsPinGetReferenceClockInterface 함수(ks.h)

아티클
02/26/2024

KsPinGetReferenceClockInterface 함수는 PIN과 연결된 참조 클록에 COM 스타일 인터페이스를 반환합니다. 이 인터페이스 포인터는 IKsReferenceClock 인터페이스가 됩니다.

구문

KSDDKAPI NTSTATUS KsPinGetReferenceClockInterface(
  [in]  PKSPIN             Pin,
  [out] PIKSREFERENCECLOCK *Interface
);

매개 변수

[in] Pin

참조 클록 인터페이스를 반환할 KSPIN 구조체에 대한 포인터입니다.

[out] Interface

IKsReferenceClock 인터페이스의 주소를 수신하는 메모리 위치에 대한 포인터입니다. 연결된 참조 수가 있는 COM 스타일 인터페이스입니다. 미니드라이버가 완료되면 인터페이스를 해제해야 합니다.

반환 값

핀이 클록을 구현하거나 KSPROPERTY_STREAM_MASTERCLOCK 속성을 통해 master 클록의 알림을 받은 경우 KsPinGetReferenceClockInterface는 STATUS_SUCCESS 반환하고 IKsReferenceClock 인터페이스의 주소를 인터페이스에 보관합니다. 핀이 아직 master 클록의 알림을 받지 못한 경우 STATUS_DEVICE_NOT_READY 반환합니다.

설명

KsPinGetReferenceClockInterface를 호출하는 가장 일반적인 시간은 KSSTATE_ACQUIRE 상태로 전환됩니다.

이 루틴에서 반환하는 IKsReferenceClock 인터페이스 사용에 대한 자세한 내용은 AVStream Clocks를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ks.h(Ks.h 포함)
라이브러리	Ks.lib
IRQL	PASSIVE_LEVEL