次の方法で共有

IEnumRegFilters::Next メソッド (strmif.h)

  • [アーティクル]

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

メモIEnumRegFilters インターフェイスは非推奨です。
 
列挙子の作成時に指定された要件を満たすフィルターの次のセット ( cFilters パラメーターで指定) の説明を配列に入力します。

構文

HRESULT Next(
  [in]  ULONG     cFilters,
  [out] REGFILTER **apRegFilter,
  [out] ULONG     *pcFetched
);

パラメーター

[in] cFilters

フィルターの数。

[out] apRegFilter

REGFILTER ポインターの配列へのポインターのアドレス。

[out] pcFetched

渡されたフィルターの実際の数へのポインター。

戻り値

次のいずれかの HRESULT 値を 返します。

リターン コード 説明
E_INVALIDARG
 引数が無効です。
E_OUTOFMEMORY
 メモリ不足です。
E_POINTER
 NULL ポインター引数。
E_UNEXPECTED
 予期しないエラー。
S_FALSE
 取得されたフィルターの数は、要求されたフィルターよりも少なくなります。
S_OK
 正常終了しました。
VFW_E_ENUM_OUT_OF_SYNC
 列挙子が無効になりました。 詳細については、「解説」を参照してください。

注釈

呼び出し元のアプリケーションは、配列で返される各 REGFILTER ポインターを解放するために、Microsoft Win32 CoTaskMemFree 関数を使用する必要があります。 REGFILTER 構造体の一部としてこの文字列のメモリを割り当てるのでIEnumRegFilters::Next、REGFILTER 構造体の Name メンバーを個別に解放しないでください。

登録済みフィルターの数が変更されると、列挙子の状態はレジストリの状態と一致しなくなります。 その結果、このメソッドはVFW_E_ENUM_OUT_OF_SYNCを返します。 以前の列挙子の呼び出しから取得したデータは無効である可能性があるため破棄し、 Reset メソッドを呼び出して列挙子を更新する必要があります。 その後、 メソッドを安全に Next 呼び出すことができます。

要件

要件 値
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)

こちらもご覧ください

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

IEnumRegFilters インターフェイス