IMFMediaSink::GetCharacteristics メソッド (mfidl.h)
メディア シンクの特性を取得します。
構文
HRESULT GetCharacteristics(
[out] DWORD *pdwCharacteristics
);
パラメーター
[out] pdwCharacteristics
0 個以上のフラグのビットごとの OR を受け取ります。 次のフラグが定義されています。
| 値 | 意味 |
|---|---|
|
メディア シンクには、固定数のストリームがあります。 IMFMediaSink::AddStreamSink メソッドと IMFMediaSink::RemoveStreamSink メソッドはサポートされていません。 このフラグは、アプリケーションのヒントです。 |
|
メディア シンクは、外部クロックとレートを一致させることはできません。
最適な結果を得るには、このメディア シンクをプレゼンテーション クロックのタイム ソースとして使用する必要があります。 他のタイム ソースが使用されている場合、メディア シンクはクロックとレートを一致させることができず、結果が悪くなります (グリッチなど)。 パイプラインの構成方法が制限されるため、このフラグは慎重に使用する必要があります。 プレゼンテーションクロックの詳細については、「 プレゼンテーションクロック」を参照してください。 |
|
メディア シンクはレートレスです。 サンプルは可能な限り迅速に使用され、プレゼンテーション クロックに同期されません。
ほとんどのアーカイブ シンクはレートレスです。 |
|
メディア シンクにはプレゼンテーション クロックが必要です。 プレゼンテーション クロックは、メディア シンクの IMFMediaSink::SetPresentationClock メソッドを 呼び出すことによって設定されます。
このフラグは廃止されました。メディア シンクは、(レートレス メディア シンクのように) クロックを無視する場合でも、すべてのメディア シンクで SetPresentationClock メソッドをサポートする必要があるためです。 |
|
メディア シンクは、プレゼンテーション クロックが開始される前に、事前登録サンプルを受け入れることがあります。 メディア シンクは 、IMFMediaSinkPreroll インターフェイスを 公開します。 |
|
最初のストリーム シンク (インデックス 0) は参照ストリームです。 他のストリーム シンクでメディアの種類を設定するには、参照ストリームにメディアの種類が必要です。 |
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
メディア シンクの Shutdown メソッドが呼び出されました。 |
注釈
メディア シンクの特性は、シンクの有効期間中に固定されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfidl.h |
| Library | Mfuuid.lib |