共用方式為

IPart：：GetControlInterface 方法 (devicetopology.h)

  • 發行項

如果這個元件支援 ，GetControlInterface 方法會取得指定控制項介面的參考。

語法

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

參數

[in] nIndex

控制項介面編號。 如果元件支援 n 個控制項介面，則控制項介面會編號為 0 到 n– 1。

[out] ppInterfaceDesc

指標變數的指標，方法會寫入指定音訊函式之 IControlInterface 介面的位址。 透過這個方法，呼叫端會取得介面的計數參考。 呼叫端負責藉由呼叫介面的 Release 方法，在不再需要介面時釋出介面。 如果 GetControlInterface 呼叫失敗， *ppFunction 為 Null。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼 描述
E_POINTER
 指標 ppFunction 為 Null。
E_INVALIDARG
 參數 nIndex 超出範圍。
E_NOTFOUND
 元件沒有控制項介面。

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 devicetopology.h

另請參閱

IControlInterface 介面

IPart 介面