iCreateDevEnum：：CreateClassEnumerator 方法 (strmif.h)

  • 發行項

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

CreateClassEnumerator 方法會為指定的裝置類別建立列舉值。

語法

HRESULT CreateClassEnumerator(
  [in]  REFCLSID     clsidDeviceClass,
  [out] IEnumMoniker **ppEnumMoniker,
  [in]  DWORD        dwFlags
);

參數

[in] clsidDeviceClass

指定裝置類別類別 (CLSID) 的類別識別碼。 請參閱 篩選類別。

[out] ppEnumMoniker

接收 IEnumMoniker 介面的指標。 呼叫端必須釋放 介面。

[in] dwFlags

零個或多個旗標的位元組合。 如果為零，方法會列舉類別中的每個篩選。 如果已設定任何旗標，列舉只會包含符合指定旗標的篩選條件。 已定義下列旗標：

旗標 描述
CDEF_DEVMON_CMGR_DEVICE 使用音訊壓縮管理員 (ACM) 或視訊壓縮管理員 (VCM) ，列舉音訊或視訊編解碼器。
CDEF_DEVMON_DMO (DMO) 列舉 DirectX 媒體物件。
CDEF_DEVMON_FILTER 列舉原生 DirectShow 篩選條件。
CDEF_DEVMON_PNP_DEVICE 列舉 隨插即用 硬體裝置。

傳回值

傳回下列其中一個 HRESULT 值。

傳回碼 描述
S_OK
 成功。
E_OUTOFMEMORY
 記憶體不足。
S_FALSE
 clsidDeviceClass 指定的類別不存在或空白。
E_POINTER
 NULL 指標自變數。

備註

如果類別不存在或空白，傳回值會S_FALSE，而 ppEnumMoniker 參數會接收 NULL值。 因此，測試傳回值S_OK，而不是使用 SUCCEEDED 宏：

C++ 
IEnumMoniker *pEnum = NULL;
hr = pSysDevEnum->CreateClassEnumerator(
    CLSID_VideoCompressorCategory, &pEnum, 0);
if (hr == S_OK) 
{
    // Safe to dereference pEnum.
    pEnum->Release();
}
使用 IEnumMoniker 介面來列舉代表裝置類別中篩選條件的 Moniker。 Monikers 支援 IMoniker 介面。 CreateClassEnumerator 所建立的Monikers也支援 IGetCapabilitiesKey 介面。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

ICreateDevEnum 介面