Pin 屬性集

  • 發行項

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

pin 屬性集會傳回篩選上針腳的釘選類別。 類別是由建立釘選時的篩選準則所設定;類別會指出此釘選傳遞或接收的資料類型。

標籤 值
屬性集 GUID AMPROPSETID_Pin

 

屬性識別碼 描述
AMPROPERTY_PIN_CATEGORY 指定針腳的類別。

 

DirectShow 會在 Uuids.h 標頭檔中定義下列釘選類別。

類別 GUID Description
PIN_CATEGORY_ANALOGVIDEOIN 擷取篩選的輸入針腳，其採用類比和數位。
PIN_CATEGORY_CAPTURE 擷取針腳。
PIN_CATEGORY_CC 釘選提供來自第 21 行的隱藏式輔助字幕資料。
PIN_CATEGORY_EDS 釘選提供延伸資料服務 (行 21，甚至是欄位) 。
PIN_CATEGORY_NABTS 釘選提供北美洲影片文字標準資料。
PIN_CATEGORY_PREVIEW 預覽釘選。
PIN_CATEGORY_STILL 提供仍在影像的釘選。 篩選準則的擷取針腳必須先連接，才能連接仍然映射針腳。
PIN_CATEGORY_TELETEXT 釘選 (隱藏式輔助字幕變體) 。
PIN_CATEGORY_TIMECODE 提供 timecode 資料的針腳。
PIN_CATEGORY_VBI 針腳提供垂直空白間隔資料。
PIN_CATEGORY_VIDEOPORT 要連接到 重迭混合器上輸入針腳零的視訊輸出針腳。
PIN_CATEGORY_VIDEOPORT_VBI 要連線到 VBI Surface 配置器的針腳，這是配置正確視訊記憶體所需的 VBI 介面配置器篩選，例如使用視訊埠的案例中的隱藏式輔助字幕重迭等專案。 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 函式來釋放介面指標。

 

擷取篩選準則的釘選需求

屬性集

使用釘選類別