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 | nullptr 为 ppvFactory 提供。 |
备注
在 IDXCoreAdapterFactory 接口、IDXCoreAdapterList 接口或 IDXCoreAdapter 接口上存在引用的持续时间内,对 DXCoreCreateAdapterFactory、IDXCoreAdapterList::GetFactory 或 IDXCoreAdapter::GetFactory 的其他调用将返回指向同一对象的指针,从而增加 IDXCoreAdapterFactory 接口的引用计数。
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈