IAMExtTransport：：GetTransportBasicParameters 方法 (strmif.h)

  • 项目

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 GetTransportBasicParameters 检索外部传输的常规属性。

语法

HRESULT GetTransportBasicParameters(
  [in]      long     Param,
  [in, out] long     *pValue,
  [in, out] LPOLESTR *ppszData
);

参数

[in] Param

指定要接收的属性。

[in, out] pValue

指向接收 长 整数值的变量的指针。 有关更多信息，请参见备注。

[in, out] ppszData

指向接收字符串的 LPOLESTR 类型的变量的指针。 有关更多信息，请参见备注。

返回值

此方法成功后，将返回S_OK。 否则，它将返回 HRESULT 错误代码。

注解

Param 参数是指定要检索的属性的标志。 某些属性是数值;这些在 pValue 参数中返回。 其他属性是字符串值;这些在 ppszData 参数中返回。 有关标志和预期值的列表，请参阅 IAMExtTransport：：SetTransportBasicParameters。

如果 方法返回字符串，则调用方必须使用 CoTaskMemFree 函数释放该字符串。

DV 和 MPEG 摄像机实现

MSDV 支持以下附加标志：

  • ED_RAW_EXT_DEV_CMD：调用原始 AV/C 命令。 将 AV/C 命令指定为 ppszData 参数中的字节数组。 在 pValue 参数中指定命令的大小（以字节为单位）。 方法返回时， ppszData 包含来自设备的响应， pValue 包含响应的大小（以字节为单位）。 AV/C 命令直接传递到设备，无需验证或错误检查。

    响应有效负载可能大于 命令。 调用方负责在缓冲区中为响应分配足够的空间。 最大有效负载大小为 512 个字节。

    有关详细信息，请参阅 发出原始 AV/C 命令。

  • ED_TRANSBASIC_INPUT_SIGNAL：检索 DV 摄像机设计为接受的信号格式。 在 pValue 中返回以下常量之一。
    一直 说明
    ED_TRANSBASIC_SIGNAL_525_60_SD NTSC SD 信号。
    ED_TRANSBASIC_SIGNAL_525_60_SDL NTSC SDL (长时间播放) 信号。
    ED_TRANSBASIC_SIGNAL_625_50_SD PAL SD 信号。
    ED_TRANSBASIC_SIGNAL_625_50_SDL PAL SDL (长时间播放) 信号。
    ED_TRANSBASIC_SIGNAL_MPEG2TS D-VHS 信号。
     
  • ED_TRANSBASIC_OUTPUT_SIGNAL：检索 DV 摄像机旨在传输的信号格式。 返回为ED_TRANSBASIC_INPUT_SIGNAL标志列出的常量之一。

MSTape 支持ED_TRANSBASIC_INPUT_SIGNAL和ED_TRANSBASIC_OUTPUT_SIGNAL的其他值。

一直 说明
ED_TRANSBASIC_SIGNAL_2500_60_MPEG 25 Mbps/60 MPEG 流。
ED_TRANSBASIC_SIGNAL_1250_60_MPEG 12.5 Mbps/60 MPEG 流。
ED_TRANSBASIC_SIGNAL_0625_60_MPEG 6.25 Mbps/60 MPEG 流。
ED_TRANSBASIC_SIGNAL_2500_50_MPEG 25 Mbps/50 MPEG 流。
ED_TRANSBASIC_SIGNAL_1250_50_MPEG 12.5 Mbps/50 MPEG 流。
ED_TRANSBASIC_SIGNAL_0625_50_MPEG 6.25 Mbps/50 MPEG 流。
ED_TRANSBASIC_SIGNAL_UNKNOWN 未知信号格式。
 

这些标志在头文件 Xprtdefs.h 中定义。

在 Windows XP Service Pack 2 及更高版本中，为ED_TRANSBASIC_INPUT_SIGNAL和ED_TRANSBASIC_OUTPUT_SIGNAL标志定义了以下附加信号类型。

一直 说明
ED_TRANSBASIC_SIGNAL_525_60_DV25 DVCPRO 25,525-60。
ED_TRANSBASIC_SIGNAL_625_50_DV25 DVCPRO 25,625-50。
ED_TRANSBASIC_SIGNAL_525_60_DV50 DVCPRO 50、525-60。
ED_TRANSBASIC_SIGNAL_625_50_DV50 DVCPRO 50、625-50。
ED_TRANSBASIC_SIGNAL_HD_60_DVH1 DVCPRO 100、1080i 或 720p
ED_TRANSBASIC_SIGNAL_HD_50_DVH1 仅限 DVCPRO 100、1080i
 

若要使用这些常量，请包含Windows SDK中的头文件 Xprtdefs.h。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

IAMExtTransport 接口