IDXCoreAdapterList::GetFactory 方法

检索指向 DXCore 适配器工厂对象的 IDXCoreAdapterFactory 接口指针。 有关编程指南和代码示例,请参阅 使用 DXCore 枚举适配器

语法

virtual HRESULT STDMETHODCALLTYPE GetFactory(
  REFIID riid,
  _COM_Outptr_ void** ppvFactory) = 0;

template <class T>
HRESULT GetFactory(
  _COM_Outptr_ T** ppvFactory);

参数

riid

类型: REFIID

对要在 ppvFactory 中返回的接口 (GUID) 的全局唯一标识符的引用。 这应该是 IDXCoreAdapterFactory (IID) 的接口标识符。

ppvFactory [out]

类型: void**

指向具有 riid 参数中指定的 IID 的接口的指针的地址。 成功返回后, *ppvFactory (取消引用的地址) 包含指向现有 DXCore 适配器工厂对象的指针。 在返回之前,函数递增工厂对象的 IDXCoreAdapterFactory 接口上的引用计数。

返回

类型: HRESULT

如果函数成功,则返回 S_OK。 否则,它将返回 HRESULT错误代码

返回值 说明
E_NOINTERFACE riid 提供的值无效。
E_POINTER nullptrppvFactory 提供。

备注

IDXCoreAdapterFactory 接口、IDXCoreAdapterList 接口或 IDXCoreAdapter 接口上存在引用的持续时间内,对 DXCoreCreateAdapterFactoryIDXCoreAdapterList::GetFactory 或 IDXCoreAdapter::GetFactory 的其他调用将返回指向同一对象的指针,从而增加 IDXCoreAdapterFactory 接口的引用计数。

另请参阅

IDXCoreAdapterListDXCore 参考使用 DXCore 枚举适配器