IAMTimecodeDisplay：：GetTCDisplay 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 GetTCDisplay 检索时间码字符生成器输出的当前设置。
语法
HRESULT GetTCDisplay(
[in] long Param,
[out] long *pValue
);
参数
[in] Param
时间代码显示特征。 指定要获取其设置的以下项之一。
| 值 | 说明 |
|---|---|
| ED_TCD_BORDER | 白色边框用于黑色字符，黑色边框用于白色字符。 |
| ED_TCD_INTENSITY | 字符的强度 (亮度) 。 |
| ED_TCD_INVERT | 白色背景中的黑色字符或黑色背景上的白色字符。 |
| ED_TCD_POSITION | 字符的位置。 |
| ED_TCD_SIZE | 字符大小。 |
| ED_TCD_SOURCE | 显示数据的源。 |
| ED_TCD_TRANSPARENCY | 字符的透明度。 |
[out] pValue
指向 参数中指定的参数的当前设置的指针。 此参数检索以下值之一。
如果 参数中ED_TCD_SOURCE指定，将返回下列值之一。
| 值 | 说明 |
|---|---|
| ED_TCG | 时间代码生成器 |
| ED_TCR | Timecode 读取器 |
如果ED_TCD_SIZE 在 Param 中指定，将返回以下值之一。
| 值 | 说明 |
|---|---|
| ED_LARGE | 大型 |
| ED_MED | 中型 |
| ED_SMALL | 小 |
如果 参数中ED_TCD_POSITION指定，将返回下列值之一。
| 值 | 说明 |
|---|---|
| ED_BOTTOM | 底部 |
| ED_MIDDLE | Middle |
| ED_TOP | 顶部 |
结合以下任一项。
| 值 | 说明 |
|---|---|
| ED_CENTER | Center |
| ED_LEFT | Left |
| ED_RIGHT | Right |
如果ED_TCD_INTENSITY 参数中指定的，将返回下列值之一。
| 值 | 说明 |
|---|---|
| ED_HIGH | 高 |
| ED_LOW | 低 |
如果在 Param 中指定了ED_TCD_TRANSPARENCY，则返回一个介于 0 到 4 的值，0 完全不透明。
如果在 Param 中指定了ED_TCD_INVERT，将返回以下值之一。
| 值 | 说明 |
|---|---|
| OAFALSE | 白色背景上的黑色字符 |
| OATRUE | 黑色背景上的白色字符 |
如果 参数中ED_TCD_BORDER指定，将返回下列值之一。
| 值 | 说明 |
|---|---|
| OAFALSE | 白色边框的黑色字符 |
| OATRUE | 黑色字符的白色边框 |
返回值
返回一个 HRESULT 值，该值取决于接口的实现。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |