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 を含む) |