IMFMediaSink::GetCharacteristics 方法 (mfidl.h)
取得媒體接收的特性。
語法
HRESULT GetCharacteristics(
[out] DWORD *pdwCharacteristics
);
參數
[out] pdwCharacteristics
接收零個或多個旗標的位 OR 。 已定義下列旗標:
值 | 意義 |
---|---|
|
媒體接收具有固定數目的數據流。 它不支援 IMFMediaSink::AddStreamSink 和 IMFMediaSink::RemoveStreamSink 方法。 此旗標是應用程式的提示。 |
|
媒體接收無法比對速率與外部時鐘。
為了獲得最佳結果,此媒體接收應該作為簡報時鐘的時間來源。 如果使用任何其他時間來源,媒體接收就無法比對時鐘的速率,例如,問題) (不佳的結果。 此旗標應該謹慎使用,因為它會限制管線的設定方式。 如需簡報時鐘的詳細資訊,請參閱 簡報時鐘。 |
|
媒體接收是無速率的。 它會儘快取用樣本,而且不會將本身同步處理到簡報時鐘。
大部分封存接收都是無速率的。 |
|
媒體接收需要簡報時鐘。 簡報時鐘是藉由呼叫媒體接收的 IMFMediaSink::SetPresentationClock 方法來設定。
此旗標已過時,因為所有媒體接收都必須支援 SetPresentationClock 方法,即使媒體接收忽略時鐘 (,如同無速率媒體接收) 一樣。 |
|
媒體接收可以在簡報時鐘開始之前接受預先註冊範例。 媒體接收會公開 IMFMediaSinkPreroll 介面。 |
|
第一個數據流接收 (索引 0) 是參考數據流。 參考數據流必須具有媒體類型,才能在其他數據流接收上設定媒體類型。 |
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | Description |
---|---|
|
此方法已成功。 |
|
已呼叫媒體接收的 Shutdown 方法。 |
備註
媒體接收的特性會在接收的生命週期內固定。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | mfidl.h |
程式庫 | Mfuuid.lib |