IMFMediaSink::GetCharacteristics 方法 (mfidl.h)
获取媒体接收器的特征。
语法
HRESULT GetCharacteristics(
[out] DWORD *pdwCharacteristics
);
参数
[out] pdwCharacteristics
接收零个或多个标志的按位 OR 。 定义了以下标志:
值 | 含义 |
---|---|
|
媒体接收器具有固定数量的流。 它不支持 IMFMediaSink::AddStreamSink 和 IMFMediaSink::RemoveStreamSink 方法。 此标志是应用程序的提示。 |
|
媒体接收器无法将速率与外部时钟匹配。
为获得最佳结果,应将此媒体接收器用作演示时钟的时间源。 如果使用任何其他时间源,则媒体接收器无法将速率与时钟匹配,结果 (较差,例如故障) 。 应谨慎使用此标志,因为它限制了管道的配置方式。 有关演示时钟的详细信息,请参阅 Presentation Clock。 |
|
媒体接收器是无速率的。 它尽可能快地使用样本,并且不会将自身同步到演示时钟。
大多数存档接收器都是无速率的。 |
|
媒体接收器需要一个演示时钟。 演示时钟是通过调用媒体接收器的 IMFMediaSink::SetPresentationClock 方法设置的。
此标志已过时,因为所有媒体接收器都必须支持 SetPresentationClock 方法,即使媒体接收器 (忽略时钟,就像在无速率媒体接收器) 中一样。 |
|
媒体接收器可以在演示时钟开始前接受预滚动样本。 媒体接收器公开 IMFMediaSinkPreroll 接口。 |
|
第一个流接收器 (索引 0) 是引用流。 引用流必须具有媒体类型,然后才能在其他流接收器上设置媒体类型。 |
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
已调用媒体接收器的 Shutdown 方法。 |
注解
介质接收器的特征在接收器的整个生命周期内都是固定的。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | mfidl.h |
Library | Mfuuid.lib |