ピン プロパティ セット

  • [アーティクル]

ピン プロパティ セットは、フィルタのピンのピン カテゴリを返す。カテゴリは、フィルタがピンを作成するときにそのフィルタによって設定される。カテゴリは、このピンに出力されるデータ型またはこのピンが受け取るデータ型を示す。

プロパティ セット GUID AMPROPSETID_Pin
プロパティ ID 説明
AMPROPERTY_PIN_CATEGORY ピンのカテゴリを指定する。

DirectShow では、Uuids.h ヘッダー ファイルに次のピン カテゴリが定義されている。

カテゴリ GUID 説明
PIN_CATEGORY_ANALOGVIDEOIN アナログ信号を入力してデジタル化するキャプチャ フィルタの入力ピン。
PIN_CATEGORY_CAPTURE キャプチャ ピン。
PIN_CATEGORY_CC Line 21 からのクローズド キャプション データを提供するピン。
PIN_CATEGORY_EDS 拡張データ サービス (Line 21、偶数フィールド) を提供するピン。
PIN_CATEGORY_NABTS 北米ビデオ テキスト規格データを提供するピン。
PIN_CATEGORY_PREVIEW プレビュー ピン。
PIN_CATEGORY_STILL 静止画を提供するピン。静止画ピンが接続される前に、フィルタのキャプチャ ピンを接続しておく必要がある。
PIN_CATEGORY_TELETEXT 文字放送 (クローズド キャプションの変種) を提供するピン。
PIN_CATEGORY_TIMECODE タイムコード データを提供するピン。
PIN_CATEGORY_VBI 垂直同期間隔データを提供するピン。
PIN_CATEGORY_VIDEOPORT オーバーレイ ミキサの入力ピン 0 に接続するビデオ出力ピン。
PIN_CATEGORY_VIDEOPORT_VBI VBI サーフェイス アロケータに接続されるピン。この VBI サーフェイス アロケータ フィルタは、ビデオ ポートが使われる場合のクローズド キャプション オーバーレイのようなものに正しいビデオ メモリを割り当てるときに必要となる。PCI、IEEE 1394、USB シナリオはこのフィルタを使わない。詳細については、「Microsoft TV テクノロジ」を参照すること。
PINNAME_VIDEO_CC_CAPTURE クローズド キャプション ピンをスライスするハードウェア。

このプロパティは読み取り専用である。

サンプル コード

次のサンプル コードは、ピンがこのプロパティ セットをサポートしているかどうかをチェックする方法と、サポートしている場合はピン カテゴリを取得する方法を示している。

HRESULT GetPinCategory(IPin *pPin, GUID *pPinCategory)
{
    HRESULT hr;
    IKsPropertySet *pKs;
    hr = pPin->QueryInterface(IID_IKsPropertySet, (void **)&pKs);
    if (FAILED(hr))
    {
        // ピンは IKsPropertySet をサポートしていない。
        return hr;
    }
    // ピン カテゴリを取得しようとする。
    DWORD cbReturned;
    hr = pKs->Get(AMPROPSETID_Pin, AMPROPERTY_PIN_CATEGORY, NULL, 0, 
        pPinCategory, sizeof(GUID), &cbReturned);

    // この呼び出しに成功すると、pPinCategory にはカテゴリ GUID が格納される。

    pKs->Release();
    return hr;
}

参照