IMFMediaSink::GetCharacteristics 方法 (mfidl.h)

取得媒體接收的特性。

語法

HRESULT GetCharacteristics(
  [out] DWORD *pdwCharacteristics
);

參數

[out] pdwCharacteristics

接收零個或多個旗標的位 OR 。 已定義下列旗標:

意義
MEDIASINK_FIXED_STREAMS
0x00000001
媒體接收具有固定數目的數據流。 它不支援 IMFMediaSink::AddStreamSinkIMFMediaSink::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。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 Description
S_OK
此方法已成功。
MF_E_SHUTDOWN
已呼叫媒體接收的 Shutdown 方法。

備註

媒體接收的特性會在接收的生命週期內固定。

規格需求

需求
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfidl.h
程式庫 Mfuuid.lib

另請參閱

IMFMediaSink

媒體接收