IMFMediaSink::GetCharacteristics メソッド (mfidl.h)

  • [アーティクル]

メディア シンクの特性を取得します。

構文

HRESULT GetCharacteristics(
  [out] DWORD *pdwCharacteristics
);

パラメーター

[out] pdwCharacteristics

0 個以上のフラグのビットごとの OR を受け取ります。 次のフラグが定義されています。

値 意味
MEDIASINK_FIXED_STREAMS
0x00000001
 メディア シンクには、固定数のストリームがあります。 IMFMediaSink::AddStreamSink メソッドと IMFMediaSink::RemoveStreamSink メソッドはサポートされていません。 このフラグは、アプリケーションのヒントです。
MEDIASINK_CANNOT_MATCH_CLOCK
0x00000002
 メディア シンクは、外部クロックとレートを一致させることはできません。

最適な結果を得るには、このメディア シンクをプレゼンテーション クロックのタイム ソースとして使用する必要があります。 他のタイム ソースが使用されている場合、メディア シンクはクロックとレートを一致させることができず、結果が悪くなります (グリッチなど)。

パイプラインの構成方法が制限されるため、このフラグは慎重に使用する必要があります。

プレゼンテーションクロックの詳細については、「 プレゼンテーションクロック」を参照してください。
MEDIASINK_RATELESS
0x00000004
 メディア シンクはレートレスです。 サンプルは可能な限り迅速に使用され、プレゼンテーション クロックに同期されません。

ほとんどのアーカイブ シンクはレートレスです。
MEDIASINK_CLOCK_REQUIRED
0x00000008
 メディア シンクにはプレゼンテーション クロックが必要です。 プレゼンテーション クロックは、メディア シンクの IMFMediaSink::SetPresentationClock メソッドを 呼び出すことによって設定されます。

このフラグは廃止されました。メディア シンクは、(レートレス メディア シンクのように) クロックを無視する場合でも、すべてのメディア シンクで SetPresentationClock メソッドをサポートする必要があるためです。
MEDIASINK_CAN_PREROLL
0x00000010
 メディア シンクは、プレゼンテーション クロックが開始される前に、事前登録サンプルを受け入れることがあります。 メディア シンクは 、IMFMediaSinkPreroll インターフェイスを 公開します。
MEDIASINK_REQUIRE_REFERENCE_MEDIATYPE
0x00000020
 最初のストリーム シンク (インデックス 0) は参照ストリームです。 他のストリーム シンクでメディアの種類を設定するには、参照ストリームにメディアの種類が必要です。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_SHUTDOWN
 メディア シンクの Shutdown メソッドが呼び出されました。

注釈

メディア シンクの特性は、シンクの有効期間中に固定されます。

要件

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

こちらもご覧ください

IMFMediaSink

メディア シンク