IMFSample::SetSampleDuration メソッド (mfobjects.h)

サンプルの期間を設定します。

構文

HRESULT SetSampleDuration(
  [in] LONGLONG hnsSampleDuration
);

パラメーター

[in] hnsSampleDuration

サンプルの期間 (100 ナノ秒単位)。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このメソッドは、期間が負の場合に成功しますが、ほとんどの種類のデータでは負の期間が有効でない可能性があります。 サンプルを使用して期間を検証するのは、 オブジェクトの役割です。

期間は 0 にすることもできます。 これは、一部の種類のデータに対して有効な場合があります。 たとえば、サンプルにはバッファーのないストリーム メタデータが含まれている場合があります。

このメソッドが呼び出されるまで、 IMFSample::GetSampleDuration メソッドは MF_E_NO_SAMPLE_DURATIONを返します。

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

  • Service Pack 2 (SP2) 以降の Windows XP。
  • Windows XP Media Center Edition 2005 と KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

要件

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

関連項目

IMFSample

メディア サンプル

タイム スタンプと期間