共用方式為

IEnumRegFilters：：Next 方法 (strmif.h)

  • 發行項

[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式代碼盡可能重寫為使用新的 API。

注意IEnumRegFilters 介面已被取代。
 
填入陣列，其中包含 cFilters 參數所指定之下一組篩選 (條件的描述，) 符合建立列舉值時所指定的需求。

語法

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

參數

[in] cFilters

篩選數目。

[out] apRegFilter

REGFILTER指標陣列的指標位址。

[out] pcFetched

傳遞之實際篩選數目的指標。

傳回值

傳回下列其中一個 HRESULT 值。

傳回碼 Description
E_INVALIDARG
 無效引數。
E_OUTOFMEMORY
 記憶體不足。
E_POINTER
 NULL 指標自變數。
E_UNEXPECTED
 非預期的錯誤。
S_FALSE
 擷取的篩選條件比要求少。
S_OK
 成功。
VFW_E_ENUM_OUT_OF_SYNC
 列舉值已變成無效。 如需詳細資訊，請參閱＜備註＞。

備註

呼叫的應用程式必須使用 Microsoft Win32 CoTaskMemFree 函式來釋放數位中傳回的每個 REGFILTER 指標。 請勿個別釋放 REGFILTER 結構的 Name 成員，因為IEnumRegFilters::Next會將此字串的記憶體配置為 REGFILTER 結構的一部分。

如果已註冊的篩選數目變更，列舉值的狀態將不再與登錄的狀態一致。 因此，此方法會傳回VFW_E_ENUM_OUT_OF_SYNC。 您應該捨棄從先前呼叫列舉值取得的任何數據，因為它可能無效，並藉由呼叫 Reset 方法來更新列舉值。 然後，您可以安全地呼叫 Next 方法。

規格需求

需求 值
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)

另請參閱

錯誤和成功碼

IEnumRegFilters 介面