REGFILTERPINS 構造体 (strmif.h)

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

構造体には REGFILTERPINS 、フィルターを登録するためのピン情報が含まれています。

構文

typedef struct REGFILTERPINS {
  LPWSTR            strName;
  BOOL              bRendered;
  BOOL              bOutput;
  BOOL              bZero;
  BOOL              bMany;
  const CLSID       *clsConnectsToFilter;
  const WCHAR       *strConnectsToPin;
  UINT              nMediaTypes;
  const REGPINTYPES *lpMediaType;
} REGFILTERPINS;

メンバー

strName

ピンの名前。 (互換性のために残されています)

bRendered

TRUE の場合、フィルターはこのピンからの入力をレンダリングします。 (入力ピンにのみ適用されます。出力ピンの場合、値は常に FALSE です)。

bOutput

TRUE の場合、このピンは出力ピンです。 それ以外の場合、ピンは入力ピンです。

bZero

TRUE の場合、フィルターにはこのピンのインスタンスを 0 個指定できます。

bMany

TRUE の場合、フィルターは、この種類のピンの複数のインスタンスを作成できます。

clsConnectsToFilter

このピンが接続するフィルターのクラス識別子 (CLSID)。 (互換性のために残されています)

strConnectsToPin

このピンが接続されるピンの名前。 (互換性のために残されています)

nMediaTypes

このピンでサポートされているメディアの種類の数。

lpMediaType

サイズ nMediaTypes の REGPINTYPES 構造体の配列へのポインター。

注釈

この構造体は、フィルター登録のために IFilterMapper2 インターフェイスで使用されます。 この構造体を使用する場合は、REGFILTER2構造体の dwVersion メンバーを 1 に設定します。 ピンの中またはピンカテゴリを登録する必要がある場合は、代わりに REGFILTERPINS2 構造を使用します。 その場合は、 REGFILTER2 構造体の dwVersion メンバーを 2 に設定します。

同等 のAMOVIESETUP_PIN 型は、クラス ファクトリ テンプレート (CFactoryTemplate) で使用されます。

strName、clsConnectsToFilter、および strConnectsToPin のメンバーは廃止されました。 これらの値はレジストリに追加されません。

詳細については、「 DirectShow フィルターを登録する方法」を参照してください。

要件

要件	値
Header	strmif.h (Dshow.h を含む)

こちらもご覧ください

DirectShow 構造体