共用方式為

CMediaControl.GetIDsOfNames 方法

  • 發行項

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

將單一成員函式和一組選擇性參數對應至一組對應的整數分派識別碼， (DISPID) ，可在 後續呼叫 CMediaControl：：Invoke 成員函式時使用。

語法

HRESULT GetIDsOfNames(
   REFIID  riid,
   OLECHAR **rgszNames,
   UINT    cNames,
   LCID    lcid,
   DISPID  *rgdispid
);

參數

riid

參考識別碼。 保留供未來使用。 必須是 Null。

rgszNames

要對應之名稱傳入陣列的指標位址。

cNames

要對應的名稱計數。

lcid

用來解譯名稱的地區設定內容。

rgdispid

呼叫端配置的陣列指標，其中每個元素都包含對應至 rgszNames 陣列中所傳遞其中一個名稱的識別碼。 第一個專案代表成員名稱;後續元素代表每個成員的參數。

傳回值

傳回下列其中一個值。

傳回碼 Description
DISP_E_UNKNOWN_CLSID
 無法辨識 CLSID。
DISP_E_UNKNOWNNAME
 不知道一或多個名稱。 傳回的 DISPID 包含對應至未知名稱之每個專案的DISPID_UNKNOWN。
E_OUTOFMEMORY
 記憶體不足。
S_OK
 成功。

規格需求

需求 值
標頭
Ctlutil.h (包含 Streams.h)
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CMediaControl 類別