固定属性集

  • 项目

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

固定属性集返回筛选器上引脚的引脚类别。 类别由筛选器在创建固定时设置;类别指示此引脚传递或接收的数据类型。

Label 值
属性集 GUID AMPROPSETID_Pin

 

属性 ID 说明
AMPROPERTY_PIN_CATEGORY 指定固定的类别。

 

DirectShow 在 Uuids.h 头文件中定义以下固定类别。

类别 GUID 说明
PIN_CATEGORY_ANALOGVIDEOIN 采用模拟并将其数字化的捕获筛选器的输入引脚。
PIN_CATEGORY_CAPTURE 捕获引脚。
PIN_CATEGORY_CC 从第 21 行提供隐藏式字幕数据的固定。
PIN_CATEGORY_EDS 第 21 行 (提供扩展数据服务的固定，甚至) 字段。
PIN_CATEGORY_NABTS 提供北美 Videotext Standard 数据的固定。
PIN_CATEGORY_PREVIEW 预览固定。
PIN_CATEGORY_STILL 提供静止图像的固定。 在连接静止图像引脚之前，必须连接筛选器的捕获引脚。
PIN_CATEGORY_TELETEXT (隐藏式字幕变体) 提供电文的固定。
PIN_CATEGORY_TIMECODE 提供时间代码数据的固定。
PIN_CATEGORY_VBI 提供垂直空白间隔数据的固定。
PIN_CATEGORY_VIDEOPORT 要连接到 覆盖混音器上输入引脚零的视频输出引脚。
PIN_CATEGORY_VIDEOPORT_VBI 固定要连接到 VBI Surface 分配器（VBI Surface 分配器筛选器），在使用视频端口的情况下为隐藏式字幕覆盖等内容分配正确的视频内存所需的 VBI Surface 分配器筛选器。 PCI、IEEE 1394 和 USB 方案不使用此筛选器。
PINNAME_VIDEO_CC_CAPTURE 硬件切片隐藏式字幕引脚

 

此属性为只读。

示例代码

以下代码演示如何检查引脚是否支持此属性集，如果是，如何获取引脚类别：

HRESULT GetPinCategory(IPin *pPin, GUID *pPinCategory)
{
    IKsPropertySet *pKs = NULL;

    HRESULT hr = pPin->QueryInterface(IID_PPV_ARGS(&pKs));
    if (FAILED(hr))
    {
        return hr;
    }

    // Try to retrieve the pin category.
    DWORD cbReturned = 0;
    hr = pKs->Get(AMPROPSETID_Pin, AMPROPERTY_PIN_CATEGORY, NULL, 0, 
        pPinCategory, sizeof(GUID), &cbReturned);
    
    // If this succeeded, pPinCategory now contains the category GUID.

    SafeRelease(&pKs);
    return hr;
}

注意

此示例使用 SafeRelease 函数释放接口指针。

 

捕获筛选器的引脚要求

属性集

使用固定类别