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