KsPinGetReferenceClockInterface 関数 (ks.h)

[アーティクル]
03/05/2024

KsPinGetReferenceClockInterface 関数は、PIN に関連付けられている参照クロックに COM スタイルインターフェイスを返します。このインターフェイスポインターは、 IKsReferenceClock インターフェイスになります。

構文

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

パラメーター

[in] Pin

参照クロックインターフェイスを返す KSPIN 構造体へのポインター。

[out] Interface

IKsReferenceClock インターフェイスのアドレスを受け取るメモリ位置へのポインター。これは、関連付けられた参照数を持つ COM スタイルのインターフェイスです。ミニドライバーは、インターフェイスが終了したら、インターフェイスを解放する必要があります。

戻り値

KsPinGetReferenceClockInterface は、STATUS_SUCCESSを返し、 IKsReferenceClock インターフェイスのアドレスを インターフェイス に入力します(pin がクロックを実装するか、 KSPROPERTY_STREAM_MASTERCLOCK プロパティを介してマスタークロックの通知を受信した場合)。マスタークロックの通知をピンがまだ受信していない場合は、STATUS_DEVICE_NOT_READYを返します。

注釈

KsPinGetReferenceClockInterface を呼び出す最も一般的な時間は、KSSTATE_ACQUIREへの状態遷移です。

このルーチンが返す IKsReferenceClock インターフェイスの使用の詳細については、「AVStream Clocks」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Microsoft Windows XP 以降のオペレーティングシステムおよび DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム	ユニバーサル
Header	ks.h (Ks.h を含む)
Library	Ks.lib
IRQL	PASSIVE_LEVEL