IMFClockStateSink::OnClockStop メソッド (mfidl.h)

プレゼンテーション クロックが停止したときに呼び出されます。

構文

HRESULT OnClockStop(
  [in] MFTIME hnsSystemTime
);

パラメーター

[in] hnsSystemTime

クロックが停止したシステム時刻 (100 ナノ秒単位)。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	メソッドが成功しました。
MF_E_SINK_ALREADYSTOPPED	非推奨になりました。 このエラー コードは使用しないでください。

解説

プレゼンテーション クロックの IMFPresentationClock::Stop メソッドが呼び出されると、クロックはプレゼンテーション タイム ソースの OnClockStop メソッドを呼び出してプレゼンテーションのタイム ソースに通知します。 この呼び出しは 、Stop メソッド内で同期的に行われます。 タイム ソースから OnClockStop からエラーが返された場合、プレゼンテーション クロックの Stop メソッドはエラーを返し、状態の変更は行われません。

プレゼンテーションの時刻ソースではないオブジェクトの場合、 OnClockStop メソッドは、状態の変更が完了した後に非同期的に呼び出されます。

オブジェクトが既に停止している場合は、OnClockStop からS_OKを返す必要があります。 エラー コードは返されません。

メモ ヘッダー ファイル mferror.h は MF_E_SINK_ALREADYSTOPPED という名前のエラー コードを定義していますが、この状況では返すべきではありません。

 

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfidl.h
Library	Mfuuid.lib

関連項目

IMFClockStateSink

MFTIME

プレゼンテーションクロック