Share via

AMOVIESETUP_FILTER構造

  • [アーティクル]

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

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

構文

typedef struct _AMOVIESETUP_FILTER {
  const  CLSID           *clsID;
  const  WCHAR           *strName;
  DWORD                  dwMerit;
  UINT                   nPins;
  const  AMOVIESETUP_PIN *lpPin;
} AMOVIESETUP_FILTER, *PAMOVIESETUP_FILTER, *FAR LPAMOVIESETUP_FILTER;

メンバー

Clsid

フィルターのクラス識別子。

strName

フィルターの名前。

dwMerit

フィルターのメリット。 フィルター グラフを作成するときに IGraphBuilder インターフェイスによって使用されます。 メリット値の一覧については、「 メリット」を参照してください。

nPins

lpPin 配列内の要素の数。 lpPin が NULL の場合は、このメンバーを 0 に設定します。

lpPin

サイズ nPin のAMOVIESETUP_PIN構造体の配列へのポインター。 この配列の各メンバーは、フィルターのピンを記述します。

解説

この構造体の使用方法については、「 DirectShow フィルターを登録する方法」を参照してください。 この構造は、既定のフィルター カテゴリ (CLSID_LegacyAmFilterCategory) に登録されているフィルターに対してのみ使用します。 別のカテゴリにフィルターを登録するには、「DllRegisterServer の実装」で説明されているように、IFilterMapper2::RegisterFilter メソッドを使用します。

注意

ヘッダー ファイル combase.h は DirectShow 基本クラスと共に提供されます。

要件

要件 値
ヘッダー
Combase.h (Streams.h を含む)

関連項目

DirectShow 構造体