共用方式為

Pin 屬性集

  • 發行項

[與此頁面相關聯的功能，DirectShow是舊版功能。 它已被 MediaPlayer、imfMediaEngine 取代，並在媒體基金會 音訊/視訊擷取。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft強烈建議新程式代碼盡可能在媒體 基礎中使用 MediaPlayer、IMFMediaEngine 和 音訊/視訊擷取，而不是 DirectShow。 Microsoft建議使用舊版 API 的現有程式代碼，盡可能改寫成使用新的 API。]

pin 屬性集會傳回篩選上針腳的釘選類別。 類別是由篩選條件在建立釘選時設定的;類別會指出此釘選所傳遞或接收的數據類型。

標籤 價值
屬性集 GUID AMPROPSETID_Pin

 

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

 

DirectShow 會在 Uuids.h 頭檔中定義下列針腳類別。

類別 GUID 描述
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 函式來釋放介面指標。

 

擷取篩選 釘選需求

屬性集

使用釘選類別