IFilterMapper::RegisterPin メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

構文

HRESULT RegisterPin(
  [in] CLSID   Filter,
  [in] LPCWSTR Name,
  [in] BOOL    bRendered,
  [in] BOOL    bOutput,
  [in] BOOL    bZero,
  [in] BOOL    bMany,
  [in] CLSID   ConnectsToFilter,
  [in] LPCWSTR ConnectsToPin
);

パラメーター

[in] Filter

フィルターの GUID。

[in] Name

ピンの名前。 これはフィルター内で一意である必要があります。 型情報を示す以外に意味はありません。 99 文字を超えるピン名は使用しないでください。フィルター列挙の問題が発生するためです。

[in] bRendered

フィルターがこの入力をレンダリングするかどうかを指定する値。 TRUE に設定すると、 TRUE に設定されます。それ以外の場合は、FALSE に設定 します。

[in] bOutput

これが出力ピンであるかどうかを示す値。 TRUE の場合は に設定します。それ以外の場合は、FALSE に設定します。

[in] bZero

フィルターにこのピンのインスタンスを 0 個含めることができるかどうかを指定する値。 可能な場合は、 TRUE に設定します。それ以外の場合は、FALSE に設定 します。 たとえば、圧縮解除フィルターは、サウンド トラックのないムービーのサウンド出力ピンを作成する必要はありません。

[in] bMany

フィルターにこのピンのインスタンスを多数含めることができるかどうかを指定する値。 可能な場合は、 TRUE に設定します。それ以外の場合は、FALSE に設定 します。 たとえば、ミキサーの入力ピンのインスタンスが複数ある場合があります。

[in] ConnectsToFilter

予約済み。 NULL にする必要があります。 (これは、フィルター グラフの外部に接続されているシステム全体のミキサーなどのフィルターを対象としています。まだ実装されていません。)

[in] ConnectsToPin

予約済み。 NULL にする必要があります。

戻り値

HRESULT 値を返します。

要件

こちらもご覧ください

エラーコードと成功コード

IFilterMapper インターフェイス