IKsReferenceClock インターフェイス (ks.h)

IKsReferenceClock インターフェイスは、すべてのピンで AVStream によって提供される COM スタイルのインターフェイスです。 ピンはマスター クロックに要求を渡します。

継承

IKsReferenceClock インターフェイスは、IUnknown インターフェイスから継承します。

メソッド

IKsReferenceClock インターフェイスには、次のメソッドがあります。

IKsReferenceClock::GetCorrelatedPhysicalTime IKsReferenceClock::GetCorrelatedPhysicalTime メソッドは、関連付けられている参照クロックに対して現在の物理時間を照会し、関連付けられたシステム時刻を取得します。
IKsReferenceClock::GetCorrelatedTime IKsReferenceClock::GetCorrelatedTime メソッドは、関連する参照クロックに対して現在のストリーム時間を照会し、関連付けられたシステム時刻を取得します。
IKsReferenceClock::GetPhysicalTime IKsReferenceClock::GetPhysicalTime メソッドは、関連付けられている参照クロックに対して現在の物理時間を照会します。
IKsReferenceClock::GetResolution IKsReferenceClock::GetResolution メソッドは、関連する参照クロックの解決を照会します。
IKsReferenceClock::GetState IKsReferenceClock::GetState メソッドは、関連付けられている参照クロックの現在のストリーミング状態を照会します。
IKsReferenceClock::GetTime IKsReferenceClock::GetTime メソッドは、関連付けられている参照クロックに対して現在の時刻を照会します。

備考

ミニドライバーは、KsPinGetReferenceClockInterfaceを呼び出すことによって、IKsReferenceClock インターフェイスを取得できます。 これは COM スタイルのインターフェイスであるため、KsPinGetReferenceClockInterface は QueryInterface 呼び出します。これにより、AddRef が呼び出され、インターフェイス ポインターがインクリメントされます。 つまり、ミニドライバーが IKsReferenceClock インターフェイスで終了すると、ミニドライバーは Releaseを呼び出して解放する必要があります。

C で記述されたクライアントは、IKsReferenceClock インターフェイスを、C++ 抽象基底クラスではなく関数のテーブルへのポインターを含む構造体として表示されます。 C++ で記述されたクライアントは、次の操作を行う場合があります。

PIKSREFERENCECLOCK RefClock;

if (NT_SUCCESS (
  KsPinGetReferenceClockInterface (
    Pin,
    &RefClock)
) {
    ... RefClock -> GetCorrelatedTime (...);
    RefClock -> Release ();
}

ただし、C で記述されたクライアントでは、代わりに次の処理が行われます。

PIKSREFERENCECLOCK RefClock;

If (NT_SUCCESS (
  KsPinGetReferenceClockInterface (
    Pin,
    &RefClock)
) {
  ... RefClock -> lpVtbl -> GetCorrelatedTime (...);
  RefClock -> lpVtbl -> Release ();
}

詳細については、「AVStream Overview」を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	ks.h

関連項目

KsPinGetConnectedFilterInterface

KsPinGetConnectedPinInterface

KsPinGetReferenceClockInterface