KsPinGetReferenceClockInterface 関数 (ks.h)
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 |